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PREFACE 

The Commodore 64 MACRO ASSEMBLER DEVELOPMENT SYSTEM 

software package allows you to program in the native 6500 series 
Assembly language code, directly on the Commodore 64 computer. 
It provides you with a very powerful macro Assembler, editor, 
loaders and two machine language monitors along with other 
support routines. These development tools operate like and provide 
the same level of direct machine interface as the Assemblers on 
much larger computers. 

This package contains everything that you will need to create, 
Assemble, load and execute 6500 series Assembly language code. 
You will notice that like the software contained on this diskette, this 
user's manual is directed towards the experienced computer user 
that already has some familiarity with the 6500 series Assembly 
language and the operations of the Commodore 64 computer. 

This product is not intended to provide the knowledge of 'how to' in 
assembly language, but provides the software tools for the 
experienced assembly language programmer. 

It is recommended that the user obtain one or more of the reference 
manuals listed below for a more detailed description of 6502 
assembly language and the Commodore 64. (The publisher is listed 
in parentheses.) 

• 6502 Assembly Language Subroutines, Leventhal and Saville 
(Osborne/McGraw-Hill) 

• 6502 Software Design. Scanlon (Howard W. Sams & Co.) 

• 6502 Assembly Language Programming, Leventhal 
(Osborne/McGraw-Hill) 

• Commodore 64 Programmer's Reference Guide 
{Commodore/Howard W. Sams & Co.) 

• Programming in 6502, Rod nay Zaks (Sybex) 

This manual has been divided into five parts for easier reference. 
Part One, "Introduction" provides a brief description of how an 
assembler works along with some basic terminology used 
throughout this manual. It is recommended that the novice user 
read this section first to obtain a feel for the level of knowledge 
needed to program in assembly language and use this manual. 

Part Two, "64 Macro Assembler Capabilities and Conventions", is 
composed of Section 1-4 and describes those capabilities and 
conventions used by this assembler. 



Part Three, "Creating and Editing Assembly Source Files", is 
composed of Sections 5-6 and decribes how to create and edit an 
assembly language source file. Section 5 contains ttie instructions 
for loading a support program or wedge. Tfiis program gives the 
user additional commands for maintaining the disk and loading and 
running programs. Section 6 contains the operating instructions for 
loading and running the Editor64 program. This program allows the 
user to create and edit assembly source files. 

Part Four of the manual, "Assembling and Testing a Program", is 
composed of Sections 7-9 and contains information on the programs 
that allow the user to assemble, test, and debug object programs. 
Section 7 describes the operation of the assembler program; 
Section 8 describes the programs that must be used to load an 
object program into memory: Section 9 describes the program that 
allows the user to monitor memory for debugging purposes. 

Finally, Part Five, "Appendices", includes those charts and tables 
that can be used as a reference to other sections. It also provides a 
quick reference to the commands available when running certain 
programs. 



USER CONVENTIONS 

Throughout this manual there are certain conventions used to help 
make explanations less ambiguous. A list of these conventions is 
given below. We recommend that the user become familiar with 
these. 



( ) 



label 

opcode 

operand 

comments 
filename 

filename* 



lower case 
variable 

UPPER CASE 

NAfWE 



Parentheses are used to denote an option. The only 
exceptions to this rule are in those sections where 
indirect indexed and indexed indirect addressing 
are explained. In these cases the parentheses are 
required. 

This is used to denote a label reference in an 
assembler source program. The actual label used is 
determined by tlie programmer. 

This is used to denote one of the 6502 instructions 
as specified in Appendix IV. 

This is used to denote the operand, or argument 
portion of an instruction. 

This is used to specify user comments. 

This is used to specify a filename on disk. The 
actual name is determined by the user. 

This is used to denote a wild card filename (i.e., a 
filename that begins with the characters preceding 

the '■•'■). 

Generally, lowercase variables specify that it is up 
to you to supply the actual data. 

Generally, UPPER CASE NAIVIES are the actual 
input to be typed. 
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INTRODUCTION 

This manual describes the Assembly Language and assembly 
process for Commodore 64 programs which use one of the 6500 
series microprocessors. Several assemblers are available for 6500 
series program development, each is slightly different in detail of 
use. yet all are the same in principle. The 6500 series processors 
include the 6502 through the 6515 (the instruction sets are identical). 

The process of translating a mnemonic or symbolic form of a 
computer program to actual machine code is called assembly, and a 
program wtnich performs the translation is an assembler. We refer to 
the symbolic form of the program as source code and the actual 
machine form as object code. The symbols used and rules of 
association for those symbols are the Assembly Language. In 
general, one Assembly Language statement will translate into one 
machine instruction. This distinguishes an assmbler from a compiler 
which may produce many machine instructions from a single 
statement. An assembler which executes on a computer other than 
the one for which code is generated, is called a cross-assembler. 
Use of cross-assemblers for program development for 
microprocessors is common because often a microcomputer 
system has fewer resources than are needed for an assembler. 
However, in the case of the Commodore 64, this is not true. With a 
floppy disk and printer, the system is well suited for software 
development. 

Normaly, digital computers use the binary number system for 
representation of data and instructions. Computers understand only 
ones and zeroes corresponding to an 'ON' or 'OFF' state. Users, on 
the other hand, find it difficult to work with the binary number 
system and hence, use a more convenient representation such as 
octal (base 8), decimal (base 10), or hexadecimal (base 16). Two 
representations of the 6500 series operation to 'load' information 
into an 'accumulator' are: 

10101001 (binary) 

A9 (hexadecimal) 

An instruction to move the value of 21 (decimal) to the accumulator 
is: 

A9 15 (hexadecimal) 



Users still find numeric representations of instructions tedious to 
work witti, and fience, hiave developed symbolic representations. For 
example, thie preceding instruction migfit be written as: 

LDA #21 

In ttiis example, LDA is the symbol for A9, Load thie Accumulator. 
An assembler can translate the symbolic form LDA to the numeric 
form A9. 

Each machine instruction to be executed has a symbolic name 
referred to as an operation code (opcode). The opcode for "store 
accumulator" is STA. The opcode for "transfer accumulator to index 
x" is TAX, The 56 opcodes for the 6500 series processors are 
detailed in Appendix IV. A machine instruction in Assembly 
Language consists of an opcode and perhaps operands, which 
specify the data on which the operation is to be performed. 

A label is a 'name' for a line of code. Instructions may be labelled 
for reference by other instructions, as shown in: 

L2 LDA #12 

The label is L2, the opcode is LDA, and the operand is #12. At least 
one blanl< must separate the three parts (fields) of the instruction. 
Additional blanks may be inserted by the programmer for ease of 
reading. Instructions for the 6500 series processors have at most 
one operand and many have none. In these cases, the operation to 
be performed is totally specified by the opcode as in CLC (Clear the 
Carry Bit). 

Programmming in Assembly Language requires learning the 
instruction set (opcodes), addressing conventions for referencing 
data, the data structures within the processor, as well as the 
structure of Assembly Language programs. The user will be aided in 
this by reading and studying the 6500 series hardware and 
programming manuals suppied with this development package. 



1.0 INSTRUCTION FORMAT CONVENTIONS 

Assembler instructions for the Commodore 64 assembler are of two 
basic types according to function: 

• Macfiine instructions, and 

• Assembler directives 

Maciiine instructions correspond to tfie 56 operations implemented 
on tfie 6500 series processors. The instruction format is: 

(label) opcode (operand) (comments) 

Fields are bracketed to indicate that they are optionai. Labels and 
comments are always optional and many opcodes sucli as RTS 
(Return from Subroutine} do not require operands. A line may also 
contain only a label or only a comment. 

A typical instruction showing ail four fields is; 

LOOP LDA BETA,X iFETCH BETA INDEXED BY X 

A field is defined as a string of characters separated by a space. 

A label is an alphanumeric string of from one to six characters, the 
first of which must be alpha. A label may not be any of the 56 
opcodes, nor any of the special single characters, i.e. A, S, P, X or Y. 
These special characters are used by the assembler to reference 
the: 

• Accumulator (A) 

• Stack pointer (S) 

• Processor status (P) 

• Index registers (X and Y) 

A label may begin in any column provided it is the first field of an 
instruction. Labels are used on instructions as branch targets and 
on data elements for reference in operands. 

The operand portion of an instruction specifies either an address or 
a value. An address may be computed by expression evaiuation and 
the assembler allows considerable flexibility in expression 
formation. An Assembly Language expression consists of a string of 
names and constants separated by operators, + . - . *, and / (add, 
subtract, multiply, and divide). Expressions are evaluated by the 
assembler to compute operand addresses. Expressions are 
evaluated left to right with no operator precedence and no 
parenthetical grouping. Note that expressions are evaluated at 
assembly time and not execution time. 



Any string of characters following the operand field is considered a 
comment and is listed, but not further processed. If the first non- 
blank character of any record is a semi-colon (;), the record is 
processed as a comment. On instructions which require no operand, 
comments may follow the opcode. At least one space must 
separate the fields of an instruction. 

Appendix V presents a sample output listing from the assembler. 
Various examples of instruction format are included. 



1.1 Symbolic 

Perhaps the most common operand addressing mode is the 
symbolic form as in: 

LDA BETA ;PUT BETA VALUE IN ACCUMULATOR 

In this example, BETA is a label referencing a byte in memory that 
contains the value to be loaded into the accumulator. BETA is a 
label for an address at which the value is located. Similarly, in the 
instruction: 

LDA ALPHA + BETA 

the address ALPHA + BETA is computed by the assembler, and the 
value at the computer address is loaded into the accumulator. 

Memory associated with the 6500 series processors is segmented 
into pages of 256 bytes each. The first page, page zero, is treated 
differently by the assembler and processor for optimization of 
memory storage space. Many of the instructions have alternate 
operation codes if the operand address is in page zero memory. In 
tfiose cases, the address is only one byte rather than the normal 
two. For example: 

LDA BETA 

If BETA is located at byte 4B in page zero memory, then the code 
generated is A5 B4. This is called page zero addressing. If BETA is 
at 01 30 in memory page one, the code generated is AD 30 OT This 
is an example of 'absolute' addressing. Thus, to optimize storage 
and execution time, a programmer should design with data areas in 
page zero memory whenever possible. (Please avoid assembling 
code in page zero, as problems may be encountered.) Remember, 
the asembler makes decisions on which form to use, based on 
operand address computation. 



1.2 Constants 

Constant values in Assembler Language can take several forms. If a 
constant is other than decinnal, a prefix cfiaracter is used to specify 
type: 

$ (Dollar sign) specifies hiexadecimal 
@ (Commercial at) specifies octal 
% (Percent) specifies binary 

(Apostropfie) specifies an ASCII literal character in 

immediate instructions. 

The absence of a prefix symbol indicates decial value. In the 
statement: 

LDA BETA + 5 
the decimal number 5 is added to BETA to computer the address. 
Similarly; 

LDA BETA + $5F 

denotes that the hexadecimal value of 5F is to be added to BETA 
for the address computation. 

The immediate mode of addressing is signified by a # (pound sign) 
followed by a constant. For example: 

LDA #2 

specifies that the decimal value 2 is to be put into the accumulator. 
Similarly; 

LDA #'G 

will load the ASCII value of the character G into the accumulator. 
Since the accumulator is one byte, the value loaded must be in the 
range of to 255 decimal. 

Immediate mode addressing generates two or three bytes of 
machine code (depending on whether or not zero page addressing is 
used), the opcode, and the value to be used as operand. Note that 
constant values can be used in address expressions and as values 
in immediate mode addressing. They can also be used to initialize 
locations as explained in a later section as assembler directives. 



1.3 Relative 

There are eight conditional branch instructions available to the user. 
In this example: 

BEQ START :IF EQUAL BRANCH TO START 

if the values compared are equal, a transfer to the instruction 
labelled START is made. The branch address is a one byte positive 
or negative offset which is added to the program counter during 
execution. At the time the addition is made, the program counter is 
pointing to the next instruction beyond the branch instruction. The 
offset is based on the location of the next instruction. A branch 
address must be within 127 bytes forward or 128 bytes backward 
from the conditional branch instruction. An error will be flagged at 
assembly time if a branch target falls outside the bounds for relative 
addressing. Relative addressing is not used for any instructions 
other than branch. 



1.4 Implied 

Twenty-five instructions such as TAX (Transfer Accumulator to Index 
X) require no operand, and hence, are single byte instructions. Thus, 
the operand addresses are implied by the operation code. 

Four instructions. ASL. LSR, ROL and ROR, are special in that the 
accumulator, A. can be used as an operand. In this special case, 
these four instructions are treated as implied mode addressing and 
only an operation code is generated. 



1.5 Indexed Indirect 

In this mode, the operand address is computed by first adding ttie X 
register (ttie index) to ttie argument in ttie operand (in thie example 
below, BETA). Ttie resulting value is the indirect page zero address 
wliicli contains ttie actual operand address. In ttiis example: 

LDA (8ETA,X) 

ttie parenttieses around ttie operand indicates indirect mode. In ttie 
above example, the value in index register X is added to BETA. That 
sum must reference a location in page zero memory. During 
execution, the high order byte of the address is ignored; thus, 
forcing a page zero address. The two bytes starting at that location 
in page zero memory are taken as ttie address of the operand in low 
byte, high byte format. For purposes of illustration, assume the 
following: 

BETA contains $12 

X contains $4 

Locations $0017 and $0016 contain $01 and $25 

Location $0125 contains $37 

Then BETA + X is $16. the address at location $16 is S0125. the 
value at $0125 is S37. and hence the instruction LDA (BETA.X) loads 
the value $37 into the accumulator. (This addressing mode is often 
used for accessing a table of address vectors in page zero.) This 
form of addressing is shown in ttie following illustration. 



LDA (BETA,X 


) 


+ 4 — 


S12 + 


$14 = 


$16 


BbIA ^- 


12 






/ 


LOW BYTE 
25 


$16 / 






/ 






\ 


S17 


HIGH BYTE 
01 








VALUE 37 


SO 125 







1.6 Indirect Indexed 

Another mode of indirect addressing uses index register Y and is 
illustrated by: 

LDA (GAMMA),Y 

In this case, GAMMA references a page zero location at which an 
address is to be tound. The value in index Y is added to that 
address to compute the actual address of the operand. Suppose for 
example that: 

GAIVIMA contains $38 

Y contains S7 

Locations S0039 and S0038 contain $00 and $54 

Location SOOSB contains SI 26 

The address at S38 is $0054; seven is then added to this, giving an 
effective address $005B. The value at $005B is $126 vi/hich is loaded 
into the accumulator. 

In indexed indirect, the index X is added to the operand prior to the 
indirection. In indirect indexed, the indirection is done and then the 
index Y is added to compute the effective address. Indirect mode is 
always indexed except for a JMP instruction which allows a 
absolute indirect address, as exemplified by JMP (DELTA) which 
causes a branch to the address contained in locations DELTA and 
DELTA + 1. The indirect indexed mode of addressing is shown in the 
following illustration. 





LDA (GAMMA),Y 






$5B 


GAMMA -^- 


38 




$38 










54 








\+ 7n 


S0054 + $7 = 


$39 


00 






SOOSB 


VALUE 126 
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2.0 ASSEMBLER DIRECTIVES 

There are eleven assembler directives used to reserve storage and 
direct information to ttie assembler. Nine have symbolic names with 
a period as the first character. The tenth, a symbolic equate, uses 
an equals sign ( = ) to establish a value for a symbol. The eleventh, 
asterisk. (") means the value of the current location counter. This 
corresponds to the ORG directive in some assemblers, it is 
sometimes read as "here" or "this location". Some equate examples 
are 'RED = 5. BLUE^SFF, and * = S200". A list of the directives is 
given below {their use is explained in this section): 

.BYTE .WORD .DBYTE .PAGE .SKIP 
.OPT .END .FILE .LIB 



Labels and symbols other than directives may not begin with a 
period. 

Examples of assembler directives can be seen in the sample 
Assembler program in Appendix V. 

If desired, all directives which are preceded by the period may be 
abbreviated to the period and three characters, e.g., '.BYT'. 

.BYTE is used to reserve one byte of memory and load it with a 
value. The directive may contain multiple operands which will store 
values in consecutive bytes. ASCII strings may be generated by 
enclosing the string with quotes. (All quotes are "single" quotes, i.e, 
SHIFT 7.} It should be noted, however, that there is a limitation of 40 
ASCII characters that can be stored in each .BYTE directive. 

HERE .BYTE 2 

THERE .BYTE 1, $F, &Z. %101, 7 

ASCII .BYTE 'ABCDEFH' 

Note that numbers may be represented in the most convenient form. 
In general, any valid 6500 series expression which can be resolved 
to eight bits, may be used in this directive. If it is desired to include 
a quote in an ASCII string, insert two quotes in the string. For 
example: 

.BYTE 'JIIVl"S CYCLE' 

could be used to store: 

JiM'S CYCLE 

It should be noted that the use of arithmetic operations in the .BYTE 
directive is not supported in this version of the package. 
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.WORD is used to reserve and load two bytes of data at a time. Any 
valid expression, except for ASCII strings, may be used in the 
operand field. For example; 

HERE .WORD 2 

THERE WORD 1, $FF03, @3 

WHERE .WORD HERE, THERE 

The most common use for WORD is to generate addresses as 
shown in the previous example labelled "WHERE", which stores the 
16 bit addresses of "HERE" and "THERE". Addresses in the 6500 
series are fetched from memory in the order low-byte, then high- 
byte. Therefore, .WORD generates the value in this order. 

The hexadecimal portion of the example ($FF03) would be stored 
03,FF. If this order is not desired, use .DBYTE rather than .WORD. 

.DBTYE is exactly like .WORD, except the bytes are stored in high- 
byte, low-byte order. For example: 

.DBYTE $FF03 

will generate FF,03. Thus, fields generated by .DBYTE may not be 
used as indirect addresses. 

Equal ( = ) is the EQUATE directive and is used to reserve memory 
locations, reset the program counter (*), or assign a value to a 
symbol. 

reserve one byte 
reserve two bytes 
set program counter 
assign value 
assign value 

the ' = ' directive is very powerful and can be used for a "wide variety 
of purposes. 

Asterisk (•) directive is used to change the program counter. To 
create an object code program that starts assembly at any address 
greater than zero, the *' directive must be used. For example, 
" - S20D'. starts assembling at address $200. 

Expressions must not contain forward references or they will be 
flagged as an error. For example: 

* = C+D-E+F 

would be legal if C. D, E and F are all defined, but would be illegal if 
any of the variables were defined later on in the program. Note also 
that expressions are evaluated in strict left to right order. 



HERE 


— 


' + 


1 


WHERE 




' + 


2 


• = $200 








NB-8 








MB=NB+ 


%101 
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.PAGE is used to cause an immediate jump to top of page on the 
output listing and may also be used to generate or reset the title 
printed at the top of the output listing. 

PAGE 'THIS IS A TITLE' 

PAGE 

PAGE 'NEW TITLE' 

If a title is defined, it will be printed at the top of each page until it 
is redefined or cleared. A title may be cleared with: 

PAGE * ' 

.SKIP is used to generate blank lines in a listing. The directive will 
not appear, but its position may be found in a listing. The directive 
is treated as a valid input "list" and the list number printed on the 
left side of the listing will jump by two when the next line is printed. 

.SKIP 2 skip two blank lines 

.SKIP 3*2-1 skip five lines 

SKIP skip one line 

.OPT is the most powerful directive and is used to control the 
generation of output fields, listings and expansion of ASCII strings 
in .BYTE directives. The options available are: ERRORS, 
NOERRORS; LIST, NOLIST; GENERATE, NOGENERATE. 



OPT 


ERRORS, LIST. GENERATE 


OPT 


NOE, NOL, NOG 


Also valid is: 




.OPT 


LIST. ERR 



Default settings are: 

.OPT LIST, ERR, NOGEN 
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Here are descriptions for each of the options: 

ERRORS NOERRORS: 

Used to control creation of a separate error file. The error file 
contains the source line in error and the error message. This 
facility is normally of greatest use to time-sharing users who have 
limited print capacity. The error file may be turned on and 
examined until all errors have been corrected. This listing file may 
then be examined. Another possibility is to run with: 

.OPT ERROR, NOLIST 

until all errors have been corrected, and then make one more run 
with: 

.OPT NOERRORS. LIST 

LIST NOLIST: 

Used to control the generation of the listing file which contains 
source input, errors/warnings, code generation, symbol table and 
instruction count if enabled, 

GENERATE NOGENERATE: 

Used to control printing of ASCII strings in the .BYTE directive. 
The first two characters will always be printed, and subsequent 
characters v^ill be printed (nornnally two bytes per line), if 
GENERATE is used. 

.END should be the last directive in a file and is used to signal the 
physical end of the file. Its use is optional, but highly recommended 
for program documentation. 

.LIB allows the user to insert source code from another file into the 
assembly. When the asembler encounters this directive, it 
temporarily ceases reading source code from the current file and 
starts reading from the file named in the .LIB. Processing of the 
original source file resumes when end-of-file (EOF) or .END is 
encountered in the library file. The control file containing the .LIB 
can contain other assembler directives to turn the listing function 
on and off. etc. 

.FIL can be used to link another file to a current one during 
assembly. A library file called by a .LIB may not contain another 
.LIB. but it may contain a .FIL. A .FIL" terminates assembly of the 
file containing it and transfers source reading to the file named on 
the OPERAND. There are no restrictions on the number of files 
which may be linked by .FIL directives. Caution should be exercised 
when using this directive to ensure that no circular linkages are 
created. An assembler pass can only be terminated by (EOF) or 
.END directive. 
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3.0 MACRO CAPABILITIES 

Macros take the general form shown in the following code: 

(iabel) .MAC macro name 

TEXT OF MACRO 
(label) .MND 

The directive .MAC defines a macro with the given macro name and 
creates up to nine parameters for that macro. The user does not 
explicitly declare parameters. Macros may contain arbitrary text, 
except that they cannot contain the directives .MAC and .MND. The 
directive .MND identifies the end of a macro definition. The labels 
on .MAC and .MND are optional as denoted by the parenthesis. They 
respectively label the first generated statement and the statement 
immediately succeeding the last generated statement. 

To call a macro, the user simply gives the marco name and lists the 
parameters as indicated in the call line below: 

macroname parami, param2, 

The macro name must be delimited by a space before the first 
parameter as indicated above. 

Within the text of the macro definition, a parameter is designated by 
the temporary symbol "?" followed by a digit 1 through 9. Thus, '?3' 
designates parameter 3. During assembly, if a macro call is 
encountered, the text included in that macro is inserted into the 
assembly at that point and the parameter names at the calling point 
are substituted for the temporary names. If the user fails to supply a 
parameter name when the macro is called, the assembler will 
generate a name for that parameter (if one is needed) for the 
duration of that call. 

To give a brief example, suppose we wish to increment a double 
precision (16-bit) quantity. Then, the macro definition to do this is: 

;DOUBLE PRECISION INCREMENT 



.MAC 


DPINC 


INC 


?1 


BNE 


?2 


INC 


?1 + 1 


.MND 





?2 

When the macro is called to increment the variable COUNT, the 
following call line is used. 

DPINC COUNT 

This generates the following code: 

INC COUNT 

BNE L001 

INC COUNT+1 
L001 
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In this example, the internal label name "L001", is generated 
automaticaly during macro expansion. Subsequent calls produce 
distinct labels following the progression L002, L003. etc. If the 
programmer supplies a second parameter in the calling line, instead 
of leaving that parameter blank, the internal label name will be set 
to the second parameter instead of L001. 

Macro can call other macros, but the depth of the nesting cannot 
exceed eight levels. 



Empty Parameters 

Empty parameters in call lines are denoted by commas: 

FUNCTN AA...DD PARAMETERS ?2 AND ?3 ARE 

EMPTY AS ARE: ?5 THROUGH ?9 

FUNCTN XC.EE :?1. ?2. AND ?4 ARE EMPTY AS ARE 

?6; THROUGH ?9 

The calls on FUNCTN given here will result in different internal local 
parameters being given generated names, or names supplied from 
the programmer. 

Concatenated Names 

A macro parameter is supplied to a macro without leading or trailing 
blanks, so that a parameter can be used to create new variable 
names and allocate space for the variables. 



XX? 1 



XXAA 



XXA2 



Notice that there are no blanks in the labels XXAA and XXA2. 



.MAO 
.WOR 


DECL 



;DECLARED STORAGE 


• = • + ?2 
.MND 






DECL 
.WOR 


AA.5 



;THIS IS A MACRO CALL 


* = -+5 




;THIS IS HOW IT EXPANDS 


DECL 
.WOR 


A2,10 


;THIS IS A SECOND CALL 


*-* + 10 




;TH1S IS HOW THE SECOND CALL 
EXPANDS 
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Expressions As Parameters 

Parameters of macros can be arbitrary expressions that do not 
include embedded commas, semicolons, or blanks. When the 
expressions are inserted into the macro definition, the expression 
must make sense to the assembler. 

;IF ACCUM LESS THAN ?1 GOTO ?2 



.MAC 


LSS 


CMP 


?1 


BCS 


?2 


.MND 




LSS 


XX + 5,EXIT 


LSS 


#$F3,EXIT 


LSS 


(XX.D.EXIT 



;COMPARE WITH LOCATION XX + 5 

;G0MPAREW1TH LITERAL 

:ILLEGAL— AN EMBEDDED COMMA 

Assembler Output Format 

Note: The macro assembler uses different rules than the previous 
Commodore assembler in deciding how to format a print line. The 
new rule is the following: 

An identifier thai begins in column 1 is printed as a label, 
otherwise it is assumed to be an opcode. 

This rule is identical to the rule used by the editor for the FORMAT 
command. Hence, the FORfvlAT command now permits the user to 
view the final printed format of edited files. 
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4.0 OUTPUT FILES GEhJERATED BY THE ASSEMBLER 

There are three output files generated by the assembler. Each file is 
optional and can be created through the use of the .OPT assembler 
directive. The listing file contains the program list with errors and 
the symbol table. The error file contains all error lines and errors (as 
included in the listing file). The interface file contains the object 
code for the loader. 

The cross reference file may optionally be generated by the 
assembler. This file is used by the cross reference program to print 
a report showing all variables, their declared addresses, and all line 
numbers in which each variable is used. 

Listing File 

The listing file will be produced unless the NOLIST option is used 
on the .OPT assembler directive. This file is made up of two 
sections: Program and Error List, and Symbol Table. 

• Program and Error List 

This listing will always be produced unless the NOLIST option is 
selected. It contains the source statement of the program along 
with the assembled code. Errors and warnings appear after 
erroneous statements. (An explanation of error codes is presented in 
Appendix VI.) A count of the errors and warnings found during the 
assembly is presented at the end of the parogram. 

• Symbol Table 

The symbol take will always be produced unless the NOSYfVI option 
is used. It contains a list of all symbols used in the program, and 
their addresses. 
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Interface File 

This file does not contain true object code, but data which can be 
loaded and converted to machine code by the loader. The format for 
the first and all succeeding records, except for the last record, is as 
follows: 

; nInO a3a2a1a0 (d1dO)1 (d1d0)2...(d1d0)23 x3x2xlx0 
Where the following statements apply: 

1. All characters (n,a,d,x) are the ASCII characters zero through F, 
each representing a hexadecimal digit. 

2. The semicolon is a record mark indicating the start of a record. 

3. nInO The number of bytes of data in this record {in 

hexadecimal). Each pair of hexadecimal characters 
(d1dO) represents a single byte. 

4. a3a2a1aO The hexadecimal starting address for the record. 

The a3 represents address bits 15 thru 12, etc. The 
8-bit represented by (d1dO)1 is stored in address 
a3a2a1a0: (d1dO)2 is stored in {a3a2a1a0)+ 1, etc, 

5. (dIdO) Two hexadecimal digits representing an 8-bit byte 

of data. (d1 - high-order 4 binary bits and dO = 
low-order 4-bis). A maximum of 18 (Hex) or 24 
(decimal) bytes of data per record is permitted, 

6. x3x2x1x0 Record check sum. This is the hexadecmial sum of 

all characters in the record, including the nInO and 
a3a2a1a0, but excluding the record mark and the 
check sum of characters. To generate the check 
sum. each byte of data (represented by two ASCII 
characters) is treated as 8 binary bits. The binary 
sum of these 8-bit bytes is truncated to 16 binary 
bits (4 hexadecimal digits) and is then represented 
in the record as four ASCII characters (x3x2x1x0). 

The format for the last record in a file is as follows: 

; 00c3c2c1c0 x3x2x1x0 

1. ; 00 Zero bytes of data are in this record. The zeros 

identify this as the final record in a file. 

2. C3c2c1c0 This represents the total number of records (in 

hexadecimal) in this file, NOT including the last 
record. 

3. x3x2x1x0 Check sum for this record. 
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5.0 ADDITIONAL BASIC DISK COMMANDS (DOS SUPPORT 
WEDGE) 

On the release disk is a program which will aid you in performing 
disk housekeeping functions (copying, scratching, renaming, reading 
the directory, initializing the disk drive, checking the disk status, and 
loading (and running) programs from disk. The commands that this 
program provides are short and simple and are very useful, 

5.1 Loading the DOS WEDGE64 Program 

When this program is loaded and executed, it "wedges" itself into 
the operating system and BASIC interpreter. Thus, the wedge 
checks all keyboard entries for its command characters before 
passing the entry onto the BASIC interpreter. (This is done by 
linking into the CHRGET routine in page zero). 

To load the wedge program, enter: 

LOAD "DOS WEDGE64",8.1 

and press RETURN. This will load a program that "boots" the actual 
wedge program into memory. Once loaded, type RUN and press 
RETURN before removing the diskette. When the wedge program is 
loaded, a copyright notice will be displayed. 

5.2 Using the DOS WEDGE64 Program 

The wedge program supports all of the same commands that are 
included in BASIC (copy, scratch, rename, new a disk), a command 
to read the directory (without overwriting memory), and commands 
to load and run programs. The wedge program also provides you 
with the capability of creating and maintaining volumes of files 
(vQlumne creation allows you to group certain programs together) 
and the capability to perform operations using a wild card filename 
(and file whose name begins with certain characters,. 

Each command begins with a single character as specified in 
Section 5.3, The character used depends on the command. The @ 
(commercial at sign) and > (greater than sign) are used 
interchangeably to begin any of the disk housekeeping commands 
or to read the directory. They are also used to reset or initialize the 
drive, and to terminate the DOS Wedge. The t (up arrow) is used to 
tjegin the command to load (at BASIC'S Start of Text address) and 
automatically runs a program. The / (backslash) is used to begin 
the command to load a program at BASIC'S Start of Text address. 
The % (percent sign) is used to begin the command to load a 
program at its load address. Finally, the *- (back arrow) is used to 
begin the command for saving a file to disk. 
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5.3 DOS WEDGE64 Program Commands 

A description of each command is given in the following pages. 
Appendix IX provides a brief summary of the DOS WEDGE64 
commands. 



(lb 



Typing this character alone will provide the user with the current 
disk status. This performs the same function as the following BASIC 
code: 

10 OPEN 15,8.15 

20 INPUT#15,A.B$,C,D 

30 PRINT A:BS;C:D 

^ii${drive}:(filename)(*)([volume]) 

This command will read the directory from the disk drive specified 
and print it to the screen. If filename is specified, only that file, if 
present. m\\ be displayed. If * is specified, all files whose names 
begin with the letters specified by filename will be printed. If 
volumn is specified (where volume is the character id of that 
volume), then only those files contained on that volume will be 
printed. 

Ca N(drive):diskname,id 

This command will formal a disk using the name and id specified. 

{fi)R(drive):newfile{[volume]) = oldfile( [volume]) 

This command will rename the file specified by oldfile to the name 
specified by newfile. 

(ffiC(drive):newfile(Ivolume]} = oldfile(Evolume]) 

This command will copy the file specified by oldfile to the name 
specified by newfile. If [volume] is specified, the newfile will be 
created on that volume. 

#S(drive):filename(*)([volume]) 

This command scratches the file specified by filename. If * is 
specified, all files beginning with the letters specified by filename 
will be scratched. If [volume] is specified, only those files that are 
contained on that volume will be scratched. 

Crt U1{drivG} 
This command will reset the DOS, 

@1 (drive) 
This command will initialize the disk drive. 

@Q 
This command wilt terminate the wedge program. 
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/filename 

This command will load the file specified by filename. For example: 
/ASM.C64 

will cause the program named '■ASM.C64" to be loaded into 
memory. This command does the same thing as the BASIC 
command: 

LOAD ■■ASM.C64",8 

Please note that this command can only be used to load BASIC 
programs, or machine code programs that are booted from BASIC. 
This is because the computer will ignore the files own load address 
and will instead load at the current "Start of BASIC Text" area. 

% filename 

This command will load the file specified by filename at its own 
load address. It does the same thing as the BASIC command: 

LOAD •■filename".8,1 

where filename is the name of the program to ioad. 

t filename 

This command allows the user to load and run the program 
specified by filename and does the same thing as entering: 

LOAD ■■filename",8 

follows by the BASIC command RUN. 

Again, please note that this command can only be used to load and 
run BASIC programs, or machine code programs that are booted 
from BASIC. 

*- filename 

This command saves the program specified by filename to disk. 



21 



6.0 CREATING AND EDITING A SOURCE FILE 

The editor is used to enter and modify source files for tfie 
assembler. The editor retains all of the features of the BASIC screen 
editor and allows AUTOmattc [ine numbering, FIND. CHANGE, 
DELETE within a range, and reNUMBER. Other commands include 
GET, PUT, BREAK, KILL, and FORMAT. All of the commands are 
detailed in the summary at the end of this section. 

The editor commands operate in a similar fashion to the commands 
already existing in the computer's BASIC. For practice, we suggest 
that you try to create short example files using the editor 
commands. 

The data files on which the assembler operates are made up of 
CBM ASCII characters with each line terminated by a carriage 
return. The only restriction on data files is in naming. Due to the 
method in which the assembler parses, spaces are not allowed in 
filenames. The files are sequential and must be terminated by a zero 
byte $00. When listing a directory, these files will show as file type 
SEQ. 

Each file's format is sequential, with a terminating zero byte ($00), 
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6.1 Loading the Editor64 Program 

The editor must be loaded with the Basic LOAD command: 

LOAD "EDITOR64",8,1 
or %0:EDITOR54 (if the wedge is enabled) 

To initiate the editor, type 'SYS49152'. After typing the SYS 
command, the editor will respond with a message indicating that 
the 64 editor has been loaded. At this point. lype a NEW command 
to clear the text pointers. You are now ready to edit or enter 
assembler source files. 

6.2 Using ttie Editor64 Program 

When the Editor64 Program is in operation, any BASIC statement 
typed such as: 

10 FOR 1 = 1 TO 10 

will not be tokenized (converted into BASIC keyword tokens). Thus, 
you cannot type a BASIC line with the editor turned on. To avoid 
this problem, disable the editor with the 'KILL' command or reset 
the computer to return to Basic. 

Source files are loaded with the 'GET' command. As the file is 
loaded, the editor generates the line numbers automatically starting 
at 1000. After editing the file, insure that the last line in the file is a 
.FILE or a .END assembler directive. Then, save the file on the disk 
with the 'PUT' command. 

Important: Be sure to save your completed file using ttie PUT 
command BEFORE loading the assembler or your file will be lost. 

Refer to Appendix VII for an Editor64 Command Summary. 
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6.3 Editor64 Program Commands 

AUTO Line Numbering 

The AUTO command generates new line numbers while entering a 
new source code file. To enable the AUTO command, type the 
following: 

AUTO n1 

where n1 is the optional increment between line numbers printed. 
To disable the AUTO function, type the AUTO command without an 
increment. 

CHANGE string 

The CHANGE command automatically locates and replaces one 
string with another (multiple occurrences). This command is entered 
in the following format: 

CHANGE/str1/str2/ ,n1-n2 

/ Delimits the strl and str2 (use any character not in 

either string) 
strl Search string 
str2 Replacement string 
,nl-n2 Range parameters. The format is the same as the 

LIST command in BASIC. If omitted, the whole file 

is searched, (Optional) 

CPUT Command 

The CPUT command outputs source files with no unnecessary 
spaces to the disk for later assembly. The syntax for this command 
is the same as the PUT command. 

DELETE 

The DELETE function allows the user to delete several lines at a 
time. Simply input the range of lines to be deleted (n1 through n2). 
(The format is the same as the LIST command in BASIC). 

DELETE n1-n2 

To delete a single line, enter the line number alone on a blank line 
and press RETURN. 
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FIND String 

The FIND command is used to search for and locate specific 
character strings in text. Each occurrence of the string is printed on 
the CRT. You can pause the printing with the space bar. Printing 
can then be continued with the space bar, or terminated with the 
RUN/STOP key. The format of the FIND command is: 

FIND/stn/ ,(n1-n2) 

/ Delimiter (use a character not in the string) 

str1 Search siring 

,n1-n2 Range parameter. Same as the LIST command in 
BASIC (Optional) 

FORMATted Print 

The FORIvlAT command is used to print the text file in tabbed 
format like the assembler. For this function to work correctly, you 
must type mnemonics in column two, or one space from labels. 

FORIVlAT (n1-n2) 

n1-n2 Range parameters of the same format as LIST. 
(Optional). 

Note: This command has the same controls as FIND. For example, 
press space bar to halt printing and another space bar to restart 
printing. Press the RUN/STOP key to terminate the program. 

GET Files 

This command is used to load assembler source text files into the 
editor from disk. It can also be used to append to files already in 
memory. 

GET ■■filename" ,(n1).(n2),(n3) 

n1 Begins inputting source at this line in the file 

currently in memor/ (Optional) 
n2 Device number, default is 8 (Optional) 

n3 Secondary address default is 8 (Optional) 

Note: GET starts numbering lines at 1000 and incrementing the line 
numbers by 10. If n1 is greater than any line number in memory, the 
file being loaded is appended to the end of the current file. 
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KILL Command 

This command causes the editor to disengage. To restart the editor, 
type the same command used to start the editor (SYS49152). 

LIST Command 

The editor LIST command works in the same manner as the LIST 
command in BASIC. 

LIST(n1Hn2) 

where n1-n2 specifies a range of lines. Valid parameters also include 
'n1-' (which will list all Imes from n1 to the end) and ■■n2' (which will 
list ali lines from the beginning up to and including n2). 

ReNUMBER Lines 

The NUMBER function alllows the user to renumber all or part of 
' the file in memory. 

NUMBER (n1),(n2),(n3) 

n1 Old start line number (Optional) 

n2 New start line number (Optional) 

n3 Step size for resequence (Optional) 

PUT Command 

The PUT command outputs source files to the disk for later 
assembly. PUT has the ability to output all or part of the memory 
resident file. 

PUT "filename" ,(n1-n2),(n3},(n4) 

n1 Starting line number (Optional) 

n2 Ending line number (Optional) 

n3 Device number, default is 8 (Optional) 

n4 Secondary address, default is 8 (Optional) 

If nl-n2,n3,n4 are left out, the whole file is output to the disk. 
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7.0 ASSEMBLING A SOURCE FILE 

Once a source file is ready to assemble, you must first save it on 
disk (by using the PUT command). Please be sure to do this before 
loading the assembler program. Once this is completed, you will 
load the assembler which will reside in the same area that BASIC 
programs do. 

7.1 Loading the Asseinbler64 Program 

To load the assembler, type: 

LOAD ■■ASSEMBLER64'\8 (or /ASSEMBLER64 if the DOS 
Wedge is loaded) 

After loading is complete, type RUN and press RETURN. The 
assembler will print a copyright notice and the first user prompt 
when execution begins. 
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7.2 Using the Assembler64 Program 

When a program is being assembled, the user has the option of 
creating two types of files. The first type is an object file which 
contains the data necessary to create a machine code program {by 
the loader). The name of this file is specified by the user before 
assembly starts. The remaining files are cross reference files. The 
names for these files are automaticaily generated by the assembler 
and are in the format ■'XXLLOOOO" and "XXFFOOOO". 

It should be noted however, that the assembler program will not 
ovenwrite any of these files. If you wish to use the same object 
filename each time you assemble a program, you must -scratch" 
the old object file before you run the assembler. In the case of 
cross reference files, the same procedure should be followed if you 
want to create new cross reference files. 

Although you will be given the option of creating both an object file 
and cross reference files before assembly starts, only one of these 
options can be chosen (because of the number of files open at one 
time). If you want both files, run the assembly once with the object 
file option, and once with the cross reference option. 

When the assembler starts, the first prompt will be: 

OBJECT FILE (CR OR D:NAME): 

if you want the assembler to create an object file enter the filename 
and press RETURN. If not, press RETURN. 

Next you will be prompted with: 

HARD COPY (CR/Y OR N)? 

If you want a hardcopy printout, enter Y and press RETURN or 
simply press RETURN, tf not, enter N and press RETURN. This will 
cause the output to be listed to the screen. 

Next, you will be prompted with: 

CROSS REFERENCE (CR/NO OR Y)? 

If you want a cross reference file created, enter Y and press 
RETURN. If not, simply press RETURN. 

Finally, you will be prompted with: 

SOURCE FILE NAME? 

Enter the name of the source file that you wish to assemble. 

After entering this last prompt, the assembler program begins to 
execute. If during assembly, the symbol table overflows, the 
assembly process will stop. 
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HALTING THE ASSEMBLER 

When the assembler is running, operation may be halted by 
pressing the RUN/STOP key. If this is done, the assembly process 
will be stopped and the program will wait for the user to either 
continue the assembly or to terminate it completely. Press the B key 
to terminate the assembly and return to BASIC. Pressing any other 
key will continue the assembly process. This feature is useful for 
users without printers, as the screen listing can be examined during 
assembly, 

CROSS REFERENCE FILES 

If you chose to create a cross reference, two files will be created as 
was mentioned above. To look at or produce a hardcopy printout of 
this cross reference, you must first load the cross reference listing 
program. To load this program, type: 

LOAD "CROSSREF 64",8 

Once this program is loaded, type RUN and press RETURN and the 
cross reference listing program will prompt with: 

HARD COPY (CR/Y OR N)? 

Press RETURN if you want a hardcopy printout; otherwise, enter N 
and press RETURN. 
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8.0 LOADING AN OBJECT FILE 

The Commodore 64 Assembler produces portable output in an ASCII 
format that can not be directly executed. This output must be 
LOADED so the program can be executed. This is the function of a 
Loader. 

8.1 Loading the Loader Program 

There are two versions of the loader included on the development 
disk. Each version is positioned in a different area of RAfvl memory. 
This allows the user to load anywhere in RAM by using the correct 
loader. To load one of the Loader programs, type: 

L0AD"filename",8,1 

where filename is the program to be loaded. The following table 
shows the names, load points and run commands for each loader. 

Name Load Address Run Command 

LO-LOAD.G64 S0800 RUN 

HI-LOAD.C64 $C800 SYS 51200 
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8.2 Using the Loader Programs 

Both the HI-LOAD and LO-LOAD loaders are about 512 bytes long 
and operate in the same manner. When activated, the loaders print a 
copyright notice and prompt the user for a load offset. The offset is 
used to place object code into an address range other than the one 
that it was assembled into. This allows the user to assemble for an 
area where there is no RAM and load into a RAM area. The object 
can then be programmed into EPROM etc.. 

The offset is a two byte hexadecimal address that is added to the 
program addresses. If the program address plus the offset is greater 
than SFFFF, the address wraps around through SOOOO. The following 
examples show how offset works. 

Address of Object Code 



Program Address 


Offset 


Addre 


S0400 


$0000 


S0400 


$3000 


$0000 


$3000 


$0400 


$2000 


S2400 


$9000 


$9000 


$2000 


$E00O 


$4000 


$2000 



After the offset is entered, the loader will prompt the user for the 
object filename to be loaded. The loader will then initialize the drive, 
search for the file, and start the load. As the data is loaded, the 
program will print the input data to the CRT. This is for user 
feedback only. When the load is completed, the loader prmts the 
message 'END OF LOAD' and returns to BASIC. 

There are three errors that can occur during a load {each is self 
documenting); 

BAD RECORD COUNT 
NON-RAM LOAD 
CHECKSUM ERROR 

Errors are considered fatal; the load is terminated, the object file 
is closed, and control is returned to BASIC. 
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9.0 TESTING AND DEBUGGING WITH THE MONITOR PROGRAMS 

The MONITOR is the machine language monitor for the Commodore 
64. This programming aid contains many features that will enable 
you to create, modify and test machine language programs and 
subroutines. The MONITOR'S purpose is to make it easy for you to 
examine and change memory while debugging your program. 

9.1 Loading the MONITOR Programs 

There are two machine language monitors on the Commodore 64 
Assembler Development disk: MONITOR$8000 and MONITORSCOOO. 
The only difference is the area of memory in which the program 
resides. MONITORSSOOO resides at memory location $8000 and 
MONITORSCOOO resides at memory location $C000. The two 
MONITOR programs are both included in case one interferes with 
the intended location for the machine code program to reside. 

To load and activate the appropriate monitor, enter: 

LOAD "MONITOR$8000",8,1 (monitor at $8000) 
SYS 32768 

or 

LOAD "MONITOR$C000",8.1 (monitor at $0000) 
SYS 49152 

9.2 Using the iVtONITOR Programs 

The MONITOR programs will respond by displaying the CPU 
registers, typing a period, and flashing the cursor. The period is a 
prompt that lets you know the MONITOR program is waiting for your 
command. The commands are described on the following pages. 
Appendix VIII provides a summary of MONITOR commands. 

To exit the MONITOR program, reset the machine. 
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9.3 MONITOR Program Commands 

COMMAND: A 

Purpose: Enter a line of assembly code. 

Syntax: A(address)(opcode mnemonic) (operand) 

(address): A four-digit hexadecimal number indicating the location in 
memory to place the opcode. 

(opcode mnemonic): A standard MOS assembly language 
mnemonic, i.e. LDA, STX, ROR, etc. as defined in Appendix IV. 

(operand): The operand, when required, can be of any of the legal 
addressing modes. (For zero-page modes, a two digit hex number is 
required whose value is less than or equal to $FF. For non-zero page 
addresses, a four digit hex number wtiose value is less than or 
equal to SFFFF is required.) 

A RETURN is used to indicate the end of the assembly line. If there 
are any errors on the line, a question mark is displayed to indicate 
an error, and a period is typed on the next line. The screen editor 
can be used to correct any errors on the original line. 

After a line of code is successfully assembled, the assembler will 
print a prompt containing the next legal memory location for an 
instruction, so 'A' and the line number do not have to be typed more 
than once when typing assembly language programs into the 
Commodore 64. To exit this mode, press RETURN after the 'A' 
prompt. 

Example: .A1200 LDX #$00 
.A 1202 

COMMAND: C (COMPARE) 

Purpose: Compare two areas of memory 

Syntax: C(start address)(end address)(with address) 

(Start Address): A four digit hex number indicating the start address 
of the area of memory to compare against. 

(End Address): A four digit hex number indicating the end address 
of the area of memory to compare against. 

{With Address): A four digit hex number indicating the start 
addresss of the other area of memory to compare with. 

The address fields should be separated by a valid delimiter, such as 
a space or comma. If the two areas of memory are the same, then 
64MON will print a period, indicating that the second area of 
memory is the same as the first. The addresses, of any bytes in the 
two areas which are different, are printed out on the screen in 
descending order. 
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COMMAND: D (DISASSEMBLE) 

Purpose: Disassemble machine code into assembly language 
mnemonics and operands. 

Syntax: D(address 1)(address 2) 

(address 1): A four-digit hexadecimal starting address of the code to 
be disassembled. 

(address 2): An optional four-digit hexadecimal ending address of 
the code to be disassembled. 

The address fields should be separated by a delimiter such as a 
space or comma. The format ot the disassembly is only slightly 
different than the input format of an assembly. The difference is that 
the first character of a disassembly is a comma, rather than an 'A' 
(for readability). 

A disassembly listing can be modified using the screen editor. Make 
any changes to the mnemonic or operand on the screen, then press 
RETURN. This will enter the line and call the assembler for further 
modifications. 

A disassembly can be scrolled up or down on the screen via cursor 
control. When a line of disassembly is at the bottom of the screen, 
a cursor down will cause the screen to scroll up one line to display 
another disassembled line of code. This also works for scrolling 
backwards through a disassembly (i.e., going to the top of the 
screen and hitting cursor up). 

Example: D 1000 1400 

., 1000 LDA #S00 

., 1002 ??? 

., 1003 BNE$f1030 

COMMAND: F (FILL) 

Purpose: Fill a range of locations with a specified byte. 

Syntax: F(address 1)(address 2) (byte) 

(address 1): The first location to fill with the value specified by (byte) 

(address 2): The last location to fill with the value specified by (byte) 

(byte): A two digit hexadecimal number to be written into 
consecutive memory locations 

This command is usefu! for initializing data structures or any other 
RAM area. 

Example: F 0400 0518 EA 

Fills memory locations from $0400 to S0518 with $EA (a NOP 
instruction,) 
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COMMAND: G (GO) 

Purpose: Begin execution of a program at a specified address. 

Syntax: G(address) 

(address): An optional argument specifying the new value of thie 
program counter and address where execution is to start. When the 
address is left out, execution wilt begin at the current PC. (The 
current PC can be viewed using the R command.) 

The GO command will restore all registers (displayabte by the R 
command) and begin execution at the specified starting address. 
Caution is recommended in using the GO command. {It may 
sometimes be wise to set a breakpoint somewhere in the line of 
program execution to prevent loss of control of the operating 
system.) 

Example: G 040C 

Execution begins at location 040G. 

COMMAND: H (HUNT) 

Purpose: Hunt through memory within a specified range for all 
occurrences of a set of bytes. 

Syntax: H (address 1) (address 2) (data) 

(address 1): Beginning address of hunt procedure 

(address 2): Ending address of hunt procedure 

(data): Data set to be searched (data may be hexadecimal or an 
ASCII sthng) 

An ASCII is specified by preceding the first character with a single 
quote, i.e., 'STRING. Data may be single or multiple arguments. 
Multiple two-digit hex arguments must be separated by a space 

Example: H COOO FFFF 'READ : Search for ASCII string READ 
H AOOO A101 A9 FF 4C; Search for data $A9, $FF, $4C, 
in that sequence 
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COMMAND: t (INTERROGATE) 

Purpose: Display memory in ASCII character format within the 
specified address range. 

Syntax: 1 (ad dressi) (address 2) 

(address 1): Starting address of ASCII dump 

(address 2): Ending address of ASCII dump 

The ASCI! characters are displayed in reverse video (to contrast the 
character with the hexadecimal data displayed on the screen). 

The display can be made to scroll by using the cursor up/down key. 
This allows continuing the search beyond the search parameters. 
When a line of the listing is at the bottom of the screen, a cursor 
down will cause the screen to scroll up one line to display another 
line of the listing. This also works for scrolling backwards (i.e., 
going to the top of the screen and typing cursor up). 

Note: When a character is not printable, it will be displayed as a 
period (.). 

Example: 1 COOO C020 

Displays in REVERSE all data from SCOOO to $C020. 

COMMAND: L (1,0 AD) 

Purpose: Load a file from cassette or disk. 

Syntax: L "filename".(device) 

filename: Any legal Commodore 6^ filename 

(device): A two-digit byte indicating the device number from which 
to load 

01 is cassette 

08 is disk (or 09, etc.) 

The LOAD command causes a file to be loaded into memory. The 
starting address is contained in the first two bytes of the file (in a 
PGM file). In other words, the LOAD command always loads a file 
into the same place it was saved from. This is very important in 
machine language work, since few programs are completely 
relocatable. The file will be loaded into memory until the end of file 
marker (EOF) is found. 

Example: L ■'SCREEN". 01 :reads a file from cassette 
L '■TANK",08 :reads a file from disk drive 
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COMMAND: M (MEMORY DISPLAY) 

Purpose: To display memory as a hexadecimal dump within the 
specified address range. 

Syntax: M(address l)(address 2) 

(address 1): First address of hex dump 

(address 2): Last address of hex dump (Optional. It omitted, eight 
bytes will be displayed.) 

Memory is displayed in the foNowing format: 

.:A048 7F E7 00 AA AA AE 02 FF 

Memory content may be edited using the screen editor. To edit, 
move the cursor to the data to be modified. Type the desired 
correction and press RETURN. If there is a bad RAM location or if 
an attempt to modify ROM has occurred, an error flag (?) will be 
displayed. 

As with the DISASSEMBLY and INTERROGATE commands, the 
screen may be scrolled both up and down by using the cursor 
controls. 

Example: M 0000 

.:0000 40 7F EF AA 00 02 F7 FF 

The first eight bytes of memory are displayed. 
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COMMAND: N (NEW LOCATOR) 

Purpose: To relocate absolute memory references by adding an 
offset to Ihie operands of tfie target code. 

Syntax: N(address 1)(address 2) (offset) (ref 1)(ref 2)W 

(address 1): Starting address of code to be modified 

(address 2): Ending address of code to be modified 

(offset): Value to be added to operand of instructions 

Code moved from a higfi location to a low location in memory needs 
a value which wraps around. For example, a piece of code moved 
from SAOOO to $0400 will require an offset of $6400. 
$AOOO + $6400^S10400. but since there is not a bit nine In the 
computer, the result Is S0400. 

(ref 1): Any three byte Instruction whose operand is greater than or 
equal to (ref 1) and less than (ref 2) will be offset by the (offset) 
value, i.e.. the operand of the three byte instruction will be replaced 
by 'operand + (offset)'. 

(ref 2): Upper limit of operands to relocate (see ref 1). Any operand 
with a value greater than or equal to (ref 2) will not be relocated. 

W: Relocate word tables, (optional). Every two bytes will be offset if 
the W is included. Relocation then becomes data independent. 

Often it is useful to move a section of code from one area in 
memory to another (see the "T" command) to make room for more 
code. Then by using the "N" command, the code can be changed to 
run in the new address space. 

COMMAND: R (REGISTER DISPLAY) 

Purpose: Show important 6502 registers. The program status 
register, program counter, the accumulator, the X and Y index 
registers and the stack pointer are displayed. 

Syntax: R 

Note that the stack pointer is displayed without its Implied eighth 
bit. Since the eighth bit of the stack pointer has been mentioned, it 
Is appropriate to point out a bug in the 6502. When a PHP 
instruction is executed, the stack eighth bit of the stack pointer is 
ORe'd into the status byte and is stored on the stack with bit four 
(the break flag!) always set. For 99.9% of all applications, this 
makes no difference. However, when this bug does turn up. it 
causes problems which are very difficult to track down. 

Example: R 

PC SR AC XR YR SP 

*; 057F 01 02 03 04 FE 
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COMMAND: S (SAVE) 

Purpose: Save the contents of memor/ onto tape or disk. 

Syntax: S"filename",(device),{address1),(acldress2) 

filename: Any legal filename for saving the data. The filename must 
be enclosed in double quotes; single quotes are illegal. 

(device): Two possible devices are cassette and disk. To save on 
cassette, use device 01. The device number of the Commodore 64 
disk drive is usually 08. 
(address 1): Starting address of memory to be saved 

(address 2): Ending address of memory to be saved, plus one. All 

data up to, but not including the byte of data at this address, will be 

saved. 

The file created by this command is a load file, i.e., the first two 

bytes contain the starting address (address 1) of the data. The file 

may be recalled using the 'L' command. 

Example: 3 *'GAME".08,0400,OCOO 

saves memory from S0400 to $0C00 onto disk. 

COMMAND: T (TRANSFER) 

Purpose: Transfer segments of memory from one memory area to 
another. 

Syntax: T(address 1) (address 2) (address 3) 

(address 1): Starting address of data to be moved 

(address 2): Ending address of data to be moved 

(address 3): Starting address of new location (where the data will be 
placed) 

Data can be moved from low memory to high memory or vice-versa. 
Additional memory segments of any length can be moved forward or 
backward any number of bytes, i.e., shifted. 

Example: T 1400 1600 1401 

shifts data from $1400 up to and including $1600, one byte higher in 

memory. 
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APPENDIX I OPERATING SYSTEM MEMORY MAP 



Label 


Hex. Addr. 


Dec. Loc. 


Description 


D6510 


0000 





6510 On-Chip Data-Direction 
Register 


R6510 


0001 


1 


6510 On-Chip 8-Bit Input/ 
Output Register 




0002 


2 


Do Not Use 


ADRAY1 


0003-0004 


3-4 


Jump Vector: Convert Floating 
- Integer 


ADRAY2 


0005-0006 


5-6 


Jump Vector: Convert Integer 
-Floating 


CHARAC 


0007 


7 


Searcti Character 


ENDCHR 


0008 


8 


Flag: Scan tor Quote at End of 
String 


TRMPOS 


0009 


9 


Screen Column From Last 
TAB 


VERCK 


OOOA 


10 


Flag: 0= Load 1 = Verify 


COUNT 


000 B 


11 


Input Buffer Pointer/Number 
of Subscripts 


DIMFLG 


OOOC 


12 


Flag: Default Array Dimension 


VALTYP 


OOOD 


13 


Data Type: $ff = String 
$00- Numeric 


INTFLG 


OOOE 


14 


Data Type:$80^ Integer 
$00- Floating 


GARBFL 


OOOF 


15 


Flag: Data scan/LIST 
quote/Garbage Collect 


SUBFLG 


0010 


16 


Flag: Subscript Ref/User 
Function Call 


INPFLG 


0011 


17 


Flag: $00= INPUT $40^ GET 
S98=READ 


TANSGN 


0012 


18 


Flag: TAN sign/Comparison 
Result 




0013 


19 


Flag: INPUT Prompt 


LINNUM 


0014-0015 


20-21 


Temp: Integer Value 


TEMPPT 


0016 


22 


Pointer: Temporary String 
Stack 


LASTPT 


0017-0018 


23-24 


Last Temp String Address 


TEMPST 


0019-0021 


25-33 


Stack for Temporary Strings 


INDEX 


0022-0025 


34-37 


Utility Pointer Area 


RESHC 


0026-002A 


38-42 


Floating-Point Product of 
Multiply 


TXl tAB 


002B-002C 


43-44 


Pointer: Start of BASIC Text 


VARTAB 


002D-002E 


45-46 


Pointer: Start of BASIC 
Variables 


ARYTAB 


002F-0030 


47-48 


Pointer: Start of BASIC Arrays 


STREND 


0031-0032 


49-50 


Pointer: End of BASIC Arrays 
(+1) 
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Label 


Hex. Addr. 


Dec. Loc. 


Description 


FRETOP 


0033-0034 


51-52 


Pointer: Bottom of String 
Storage 


FRESPC 


0035-0036 


53-54 


Utility String Pointer 


MEMSI2 


0037-0038 


55-56 


Pointer: Higtiest Address 
Used by BASIC 


CURLIN 


0039-003A 


57-58 


Current BASIC Line Number 


OLDLIN 


003B-003G 


59-60 


Previous BASIC Line Number 


OLDTXT 


003D-003E 


61-62 


Pointer: BASIC Statement for 
CONT 


DATLIN 


003F-0040 


63-64 


Current DATA Line Number 


DATPTR 


0041-0042 


65-66 


Pointer: Current DATA Item 
Address 


INPPTR 


0043-0044 


67-68 


Vector: INPUT Routine 


VARNAM 


0045-0046 


69-70 


Current BASIC Variable Name 


VARPNT 


0047-0048 


71-72 


Pointer Current BASIC 
Variable Data 


FORPNT 


0049-004A 


73-74 


Pointer: Index Variable for 
FOR/NEXT 




004B-0060 


75-96 


Temp Pointer/Data Area 


FACEXP 


0061 


97 


Floating-Point Accumulator 
#1: Exponent 


FACHO 


0062-0065 


98-101 


Floating Accum. #1: Mantissa 


FACSGN 


0066 


102 


Floating Accum. #1: Sign 


SGNFLG 


0067 


103 


Pointer: Series Evaluation 
Constant 


BITS 


0068 


104 


Floating Accum. #1: Overflow 
Digit 


ARGEXP 


0069 


105 


Floating-Point Accumulator 
#2: Exponent 


ARGHO 


006A-006D 


106-109 


Floating Accum. #2: Mantissa 


ARGSGN 


006 E 


110 


Floating Accum. #2: Sign 


ARISGN 


006F 


111 


Sign Comparison Result: 
Accum. #1 vs #2 


FACOV 


0070 


112 


Floating Accum. #1. Low- 
Order (Rounding) 


RODBS 


029 D 


669 


RS-232 Start of Output Buffer 
(Page) 


R0D8E 


029 E 


670 


RS-232 Index to End of Output 
Buffer 


IRQTMP 


029F-02A0 


671-672 


Holds IRQ Vector During Tape 

I/O 

RS-232 Current Enabled 


ENABL 


02A1 


673 








Interrupts 




02A2-02FF 


674-677 


Cassette Temp Data Area 




02A6 


678 


Flag: 0=NTSC Video 1 = PAL 
Video 




02A7-02FF 


679-767 


Not Used 
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Label 


Hex. Addr. 


Dec. Loc. 


Description 


lERROR 


03CKK)301 


768-769 


Vector: Print BASIG Error 
Message 


IMAIN 


0302-0303 


770-771 


Vector: BASIG Warm Start 


ICRNCH 


0304-0305 


772-773 


Vector: Tokenize BASIC Text 


IQPLOP 


0306-0307 


774-775 


Vector: BASIG Text LIST 


IGONE 


0308-0309 


776-777 


Vector: BASIC Char Dispatch 


lEVAL 


030A-030B 


778-779 


Vector: BASIG Token 
Evaluation 


SAREG 


030C 


780 


Storage for 6502 .A Register 


SXREG 


030 D 


781 


Storage for 6502 .X Register 


SYREG 


030 E 


782 


Storage for 6502 .Y Register 


SPREG 


030 F 


783 


Storage for 6502 .SP Register 


USRPOK 


0310-0313 


784-787 


USR Function Jump Instr ($4c) 


USRADD 


0314-0315 


785-786 


USR Function Jump Address 


GINV 


0314-0315 


788-789 


Vector: Hardware IRQ 
Interrupt 


C8INV 


0316-0317 


790-791 


Vector: BRK Instr. Interrupt 


NMINV 


0318-0319 


792-793 


Vector: Non-Maskable 
Interrupt 


lOPEN 


031A-031B 


794-795 


Open a Logical File 


ICLOSE 


031C-031D 


796-797 


Close a Specified Logical File 


ICHKIN 


031 E-031 F 


798-799 


Kernal GHKIN Routine Vector 


IGKOUT 


0320-0321 


800-801 


Open Gtiannel for Output 


ICLRCH 


0322-0323 


802-803 


Close Input and Output 
Ctiannels 


1 BASIN 


0324-0325 


804-805 


Kernal CHRIN Routine Vector 


IBSOUT 


0326-0327 


806-807 


Kernal CHROUT Routine 
Vector 


ISTOP 


0328-0329 


808-809 


Scan Stop Key 


IGETIN 


032A-032B 


810-811 


Get Character from Keyboard 
Queue (Keyboard Buffer) 


ICU\LL 


032C-032D 


812-813 


Close a Specified Logical File 


USRCMD 


032E-032F 


814-815 


User-Defined Vector 


ILOAD 


0330-0331 


816-817 


Load RAfvl from a Device 


ISAVE 


0332-0333 


818-819 


Save RAM to a Device 


TBUFFR 


033G-03FB 


828-1019 


Tape I/O Buffer 
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Label Hex. Addr. Dec. Loc. 

VICSCN 0400-07FF 1024-2047 

0400-07E7 1024-2023 

07F8-07FF 2040-2047 

08Q0-9FFF 2048-40959 

8000-9 FFF 32768-40959 

AOOO-BFFF 40960-49151 

COOO-CFFF 49152-53247 

DOOO-DFFF 53248-57343 



EOOO-FFFF 57344-65535 



Description 

1024 Byte Screen Memory 

Area 

Video Matrix: 25 Lines x 40 

Columns 

Sprite Data Pointers 

Normal BASIC Program Space 

Optional Cartridge ROM - 8192 

Bytes 

BASIC ROM - 8192 Bytes (or 

8K RAM) 

RAM - 4096 Bytes 

Input/Output Devices and 

Color RAM or Character 

Generator ROM or RAM - 4096 

Bytes 

Kernal ROM - 8192 Bytes (or 

8K RAM) 
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APPENDIX II INPUT/OUTPUT REGISTER MAP 



Hex. Decimal 

0000 

0001 1 



Bits 

0-7 





1 

2 
3 

4 
5 
6-7 



Description 

MOS 6510 Data Direction Register 

(XX101111) 

Bit ^ 1:0utput Bit ^ 0: Input x = Don't Care 

MOS 6510 Micro-Processor On-Chip I/O Port 

/LORAM Signal (0 = Switcti BASIC ROM Out) 

/HIRAM Signal (O^Switcti Kernal ROM Out) 

/GHAREN Signal (0 = Switch Chiar. ROM In) 

Cassette Data Output Line 

Cassette Switcti Sense 1 =Switcti Closed 

Cassette Motor Control 1 ^ OFF = ON 

Undefined 



d000-d02e 53248-54271 MOS 6567 Video Interface Controller (VIC) 



dOOO 
dOOl 
d002 
d003 
d004 
d005 
d006 
d007 
d008 
d009 
dOOa 
dOOb 
dOOc 
dOOd 
dOOe 
dOOf 
dOlO 
dOII 



53248 
53249 
53250 
53251 
53252 
53253 
53254 
53255 
53256 
53257 
53258 
53259 
53260 
53261 
53262 
53263 
53264 
53265 



7 
6 
5 
4 

3 
2-0 



d012 53266 

d013 53267 

d014 53268 

d015 53269 

dOie 53270 



Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 
Spri 



teO 

teO 

te 

te 

te 

te 

te 

te 

te 

te 

te 

te 

te 

te 

te 

te 



Pes 
Pes 
Pos 
Pes 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 
Pos 



7-6 
5 



ites 0-7 X Pos (msb of X coord.) 
VIC Control Register 
Raster Compare: (Bit 8) See 53266 
Extended Color Text Mode: I - Enable 
Bit-Map Mode:l = Enable 
Biank Screen to Border Color: 0- Blank 
Select 24/25 Row Text Display: I - 25 Rows 
Smooth Scroll to Y Dot-Position (0-7) 
Read Raster / Write Raster Value for Compare 
IRQ 

Light-Pen Latch X Pos 
Light-Pen Latch Y Pos 
Sprite Display Enable: I = Enable 
VIC Control Register 
Unused 
Reset VIC Chip: 1 = Reset 0^ Normal 
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Hex. Decimal Bits Description 



d017 53271 
d018 53272 



d019 53273 



4 
3 
2-0 



7-4 



3-1 



7 
3 
2 
1 




dOla 53274 

dOlb 53275 

dOlc 53276 

d01d 53277 



dOle 

d01f 

d020 

d021 

d022 

d023 

d024 

d025 

d026 

d027 

d028 

d029 

d02a 

d02b 

d02c 

d02d 

d02e 



53278 
53279 
53280 
53281 
53282 
53283 
53284 
53285 
53286 
53287 
53288 
53289 
53290 
53291 
53292 
53293 
53294 



Multi-Color Mode: 1= Enable (Text or Bit-Map) 

Select 38/40 Column Text Display: 1 = 40 Cols 

Smooth Scroll to X Pos (0-7} 

Sprites 0-7 Expand 2x Vertical (Y): I ^ Expand 

VIC Memory Control Register 

Video Matrix (Screen) Base Address (in VIC 

space) 

Ctiaracter Dot-Data Base Address (in VIC 

space) 

VIC Interrupt Flag Register (Bit = 1: IRQ 

Occurred) 

Set on Any Enabled VIC IRQ Condition 

Ligtit-Pen Triggered IRQ Flag 

Sprite vs Sprite Collision IRQ Flag 

Sprite vs Background Collision IRQ Flag 

Raster Compare IRQ Flag 

IRQ Mask Register: I = IRQ Enabled 

Sprite vs Background Display Priority: 

I = Sprite 

Sprites 0-7 Multi-Color Mode Select: 

l-M.C.M. 

Sprites 0-7 Expand 2x Horizontal (X): 

I = Expand 

Sprite vs Sprite Collision Detect 

Sprite vs Background Collision Detect 

Border Color 

Background Color 

Background Color 1 

Background Color 2 

Background Color 3 

Sprite Multi-Color Register 

Sprite Multi-Color Register 1 

Sprite Color 

Sprite 1 Color 

Sprite 2 Color 

Sprite 3 Color 

Sprite 4 Color 

Sprite 5 Color 

Sprite 6 Color 

Sprite 7 Color 



d400-d7ff 54272-55295 MOS 6581 Sound Interface Device (SID) 



d400 54272 

d401 54273 

d402 54274 

d403 54275 



Frequency Control. Low-Byte 
Frequency Control. Higti-Byte 
Pulse Waveform Widtti, Low-Byte 



7-4 
3-0 



Voice I: 
Voice I: 
Voice I: 
Unused 
Voice I: Pulse Waveform Widtti, Higti-Nybble 
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Hex. Decimal 

d404 54276 



d405 54277 



d406 54278 



d407 54279 

d408 54280 

d409 54281 

d40a 54282 

d40b 54283 



d40c 54284 



d40d 54285 



d40e 54286 
d40f 54287 
d410 54288 



Bits Description 

Voice I: Control Register 
7 Select Random Noise Waveform I - On 

6 Select Pulse Waveform I -On 

5 Select Sawtooth Waveform I = On 

4 Select Triangle Waveform I = On 

3 Test Bit: I ^Disabe Oscillator 1 

2 Ring Modulate Osc. 1 with Osc. 3 Output 
l = On 

1 Synchronize Osc. 1 with Osc. 3 Frequency 
l = On 

Gate Bit: I ^ Start Att/Dec/Sus 0= Start 
Release 

Envelope Generator I: Attack/Decay Cycle 

Control 
7-4 Select Attack Cycle Duration: 0-15 
3-0 Select Decay Cycle Duration: 0-15 

Envelope Generator I: Sustain/Release Cycle 

Control 
7-4 Select Release Cycle Duration: 0-15 

Voice 2: Frequency Control, Low-Byte 

Voice 2: Frequency Control, High-Byte 

Voice 2: Pulse Waveform Width. Low-Byte 
7-4 Unused 
3-0 Voice 2: Pulse Waveform Width, High-Nybble 

Voice 2: Control Register 

7 Select Random Noise Waveform l = On 

6 Select Pulse Waveform l = On 

5 Select Sawtooth Waveform I - On 

4 Select Triangle Waveform I = On 

3 Test Bit: I ^ Disable Oscillator 2 

2 Ring Modulate Osc. 2 with Osc. 1 Output 
l = On 

1 Synchronize Osc. 2 with Osc. 1 Frequency 
I^On 

Gate Bit: I ^ Start Att/Dec/Sus = Start 

Release 

Envelope Generator 2: Attack/Decay Cycle 

Control 
7-4 Select Attack Cycle Duration: 0-15 
3-0 Select Decay Cycle Duration: 0-15 

Envelope Generator 2: Sustain/Release Cycle 

Control 
7-4 Select Sustain Cycle Amplitude Level: 0-15 
3-0 Select Release Cycle Duration: 0-15 

Voice 3: Frequency Control, Low-Byte 

Voice 3: Frequency Control, High-Byte 

Voice 3: Pulse Waveform Width, Low-Byte 
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Hex. Decimal Bits Description 



d411 54289 7-4 Unused 

3-0 Voice 3: Pulse Waveform Width, High-Nybble 
d412 54290 Voice 3: Control Register 

7 Select Random Noise Waveform l = On 

6 Select Pulse Waveform l=:On 

5 Select Sawtooth Waveform I^On 

4 Select Triangle Waveform I = On 

3 Test Bit: I =: Disable Oscillator 3 

2 Ring Modulate Osc. 3 with Osc. 2 Output 

I -On 
1 Synchronize Osc. 3 with Osc. 2 Frequency 

l = On 
Gate Bit: I -Start Att/Dec/Sus 0- Start 

Release 

Envelope Generator 3: AttacWDecay Cycle 
Control 

Select Sustain Cycle Duration: 0-15 
Select Release Cycle Duration: 0-15 
Envelope Generator Sustain/Release Cycle 
Control 

Select Sustain Cycle Amplitude Level: 0-15 
Select Release Cycle Duration: 0-15 
Filter Cutoff Frequency: Low-Nybble (Bits 2-0) 
Filter Cutoff Frequency: High-Byte 
Filter Resonance Control/Voice Input Control 
Select Filter Resonance: Min = Max = 15 
Filter External Input: I - Yes 0= No 
Filter Voice 3 Output: I = Yes 0=No 
Filter Voice 2 Output: I = Yes 0=No 
Filter Voice 1 Output: I = Yes 0=No 
Select Filter Mode and Volume 
Cut-Off Voice 3 Output: I = Off 0= On 
Select Filter High-Pass Mode: l = On 
Select Filter Band-Pass Mode: i-On 
Select Filter Low-Pass Mode: l = On 
Select Output Volume: OFF=0 Max ^15 
Analog/Digital Converter Game Paddle 1 
(0-255) 

Analog/Digital Converter: Game Paddle 2 
(0-255) 

Oscillator 3 Random Number Generator 
Envelope Generator 3 Output 

d500-d7ff 54528-55295 SID Register Images 

dSOO-dbff 55296-56319 Color Cnlrl RAM (Only Bits 3-0 Present) 

dcOOdcff 56320-56335 MOS 6526 Complex Interlace Adapter 

CIA)#1 



d413 


54291 


7-4 
3-0 


d414 


54292 


7-4 
3^ 


d415 


54293 




d416 


54294 




d417 


54295 


7-4 

3 

2 

1 



d418 


54296 


7 
6 

5 
4 
3-0 


d419 


54297 




d41A 


54298 




d41B 


54299 




d41C 


54300 
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Hex. Decimal Bits 
dcOO 56320 

7-0 

7-6 







4 






3-2 






3-0 


dcOl 


54321 


7-0 
4 

3-2 
3-0 


dc02 


56322 




dc03 


56323 




dc04 


56324 




dc05 


56325 




dc06 


56326 




dc07 


56327 




dc08 


56328 




dc09 


56329 




dcOa 


56330 




dcOb 


56331 




dcOc 


56332 ' 




dcOd 


56333 





3 
2 
1 




Description 

Data Port A (Keyboard Joystick Paddles): 

Game Port 2 

Write Keyboard Column Values for Keyboard 

Scan 

Select Paddle Input Port: 01 = Port 1 

10= Port 2 

Joystick-2 Fire Button: 0- Fire 

Paddle Fire Buttons: = Fire 

Joystick-2 Direction: Bit = 1 Open Sw, Bit = 

Closed 

Data Port B (Keyboard Joystick Paddles 

Lightpen) 

Read Keyboard Row Values for Kybrd Scan 

Joystick-1 Fire Button/Lightpen Trigger 

(0=Fire) 

Paddle Fire Buttons: 0- Fire 

Joystick-1 Direction: Bit= 1 Open Sw, Bit = 

Closed 

Data Direction Register -Port A (56320) 

Data Direction Register -Port B (56321) 

Timer A: Low-Byte 

Timer A: High-Byte 

Timer B: Low-Byte 

Timer B: High-Byte 

Time-of-Day Clock: 1/10 Seconds 

Time-of-Day Clock: Seconds 

Time-of-Day Clock: Minutes 

Time-of-Day Clock: Hours + AM/PM Flag 

(Bit 7) 

Synchronous Serial I/O Data Buffer 

CIA Interrupt Control Reg. (Read Flags/Write 

Mask) 

IRQ Flag (I = IRQ Occurred)/Mask Set Minus 

Clear Flag 

FLAG1 IRQ (Cassette Read/Serial IEEE SRQ 

Input) 

Serial Port Interrupt 

Time-of-Day Alarm Interrupt 

Timer B Underflow Interrupt 

Timer A Underflow Interrupt 
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Hex. Decimal Bits Description 

dcOe 56334 CIA Control Register A 

7 Time-of-Day Clock Frequency: 1 = 50 Hz 
0^60 Hz 

6 Serial Port Mode: I = Output 0= Input 

5 Time A Counts: I = CNT Signals 0= System 
02 Clock 

4 Force-Load Timer A: I = YES 

3 Time A Run Mode: I = Once = Continuous 

2 Timer A Output Mode to PB6: I ^Toggle 
0- Pulse 

1 Time A Output to PB6: 1 = Yes 0=No 

Start/Stop Time A: 1 = Start = Stop 
dcOf 56335 CIA Control Register B 

7 Set TOD Alarm/Clock: 1 = Alarm 0= Clock 
6-5 Time B - Mode Select: 

00 = Count System 02 Clock Pulses 

01 = Count Positive CNT Transitions 

10 = Count Timer A Underflow Pulses 

11 = Count Timer A Underflows While CNT 

Positive 
4-0 Same as Control Register A: for Timer B 

ddOOddff 56576-56591 MOS 6526 Complex Interface Adapter 

(CIA) #2 

ddOO 56576 Data Port A (Serial IEEE, RS-232, VtC Memory 

Ctl) 
7 Serial IEEE Data Input 

6 Serial IEEE Clock Pulse Input 

5 Serial IEEE Data Output 

4 Serial IEEE Clock Pulse Output 

3 Serial IEEE ATN Signal Output 

2 RS-232 Data Output (User Port) 

1-0 VIC Chiip System Memory Bank Select 
(Default = 11) 
dd01 56577 Data Port B (User Por1/RS-232 Signals) 

7 User / RS-232 Data Set Ready 

6 User / RS-232 Clear to Send 

5 User - Undefined 

4 User / RS-232 Carrier Detect 

3 User / RS-232 Ring Indicator 

2 User / RS-232 Data Terminal Ready 

1 User / RS-232 Request to Send 
User / RS-232 Received Data 

/FLAG User / RS-232 Receive: Detect Start-Bit (IRQ 
Flag) 
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Description 

Data Direction Register -Port A (56320) 

Data Direction Register -Port B (56321) 

Timer A: Low-Byte • •• 

Timer A: High-Byte 

Timer B: Low-Byte 

Timer B: High-Byte 

Time-of-Day Clock: lilO Seconds 

Time-of-Day Clocl<: Seconds 

Time-of-Day Clock: Minutes 

Time-of-Day Clock: Hours + AM/PM Flag 

(Bit?) 

Synchronous Serial I/O Data Buffer 

CIA Interrupt Control Reg. (Read Flags/Write 

Mask) 

NMI Flag (1= NM) Occurred)/Mask Set-Clear 

Flag 

FLAG2 NMI: Detects Start-Bit on Recv 

Synchronous Serial Port Interrupt 

Time-of-Day Alarm Interrupt 

Timer B Interrupt 

Timer A Interrupt 

CIA Control Register A (Same Format at 

56334) 

CIA Control Register B (Same Format at 

56335) 

deOO-deff 56832-57087 Reserved for Future I/O Expansion 

dfOO-dfff 57088-57343 Reserved for Future I/O Expansion 



Hex. 


Decimal 


Bi 


dc02 


56578 




dc03 


56579 




dc04 


56580 




dc05 


56581 




dc06 


56582 




dc07 


56583 




dc08 


56584 




dc09 


56585 




dcOa 


56586 




dcOb 


56587 




dcOc 


56588 




dcOd 


56589 


7 

4 
3 
2 
1 



dcOe 


56590 




dcOf 


56591 
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APPENDIX III DESCRIPTION OF FILES ON THE 
RELEASE DISK 



ASSEMBLER64 



BOOT ALL 



CROSSREF64 



DOS 5.1 



DOS WEDGE64 



EDITOR 64 



See Section 7. This is the actual assembler 
program which loads into low memory and 
assembles the files which were created by the 
EDITOR program. To load the assembler, type 
LOAD "ASSEMBLER64".8 or use the wedge load 
command: then type RUN, Any source text files 
not previously saved will be lost since the 
assembler toads into the same area used. 

This program loads and starts the DOS WEDGE, 
the HI-LOADER, and the EDITOR all at the same 
time. These three programs reside in different 
areas in memory, allowing their use without 
having to reload before switching programs. 

This program is used to print out the cross 
reference listing created by the assembler when 
that option is specified at assembly time. The 
program loads into low memory by using the 
LOAD ■'CROSSREF64",8 command and is started 
by typing RUN. 

This file contains the machine code for the 
wedge program. It is loaded automatically by 
running the DOS WEDGE64 program. 

See Section 5. This program is the "boot loader" 
for the DOS 5.1 wedge program. It is the first 
program on the disk so that the LOAD "*",8 
command can be used. After the program is 
loaded, type RUN and the wedge will be loaded 
and activated. 

See Section 6. This program is used to create 
and modify the source code files which will later 
be assembled. To load the editor, type LOAD 
"EDITOR64",8,1. After the program is loaded, 
type SYS 49152 to activate. Then type NEW to 
clear the pointers before proceeding to create or 
edit any files. Be sure to save the source code 
file using the PUT command before loading the 
assembler. 
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LOLOADER64 

and 
HILOADER64 



MONITOR$8000 

and 
MON1TOR$COOO 



See Section 8. These two programs are used to 
load the sequential records which are created by 
the assembler as its output or object file. When 
one of these programs is run, it loads the object 
file into memory in the specified location as true 
machine code which can be executed. The only 
difference between the two programs is that 
LOLOADER loads at hex $0800 and HILOADER 
64 loads at hex $C800. They are both included in 
case one of them interferes with the intended 
location for the machine code to reside. 

To load the $0800 version, type LOAD 
"LOLOADER64".8 and then type RUN. To load 
the SC800 version, type LOAD ■■HtLOADER64",8,1 
and then type SYS51200. 

See Section 9. These two monitor porgrams are 
identical in function and are used primarily for 
load and save binary machine code files in their 
executable form. 

They also allow the programmer many useful 
commands for examining and changing programs 
without having to run the whole assembly 
process. The first loads at hex $8000 by typing 
LOAD "MONITOR$8000",8,1 and is started by 
typing SYS32768. The second loads at hex $C000 
by typing LOAD ■■MONITOR$C000",8,1 and is 
started by typing SYS49152. 
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APPENDIX IV 6500 SERIES MICROPROCESSOR 
INSTRUCTION SET OPCODES 

ADC Add with Carry to 

Accumulator 
AND "AND" to Accumulator 
ASL Shift Left One Bit 

(Memory or Accumulator) 
BOG Brancti on Carry Clear 
BOS Brancti on Carry Set 
BEQ Brancti on Zero Result 
BIT Test Bits in Memory with 

Accumulator 
BMI Branch on Result Minus 
BNE Branch on Result not Zero 
BPL Branch on Result Plus 
BRK Force an Interrupt or Break 
BVC Branch on Overflow Clear 
BVS Branch on Overflow Set 
CLC Clear Carry Flag 
OLD Clear Decimal Mode 
CLI Clear Interrupt Disable Bit 
CLV Clear Overflow Flag 
CMP Compare Memory and 

Accumulator 
CPX Compare Memory and 

Index Y 
CPY Compare Memory and 

Index Y 
DEC Decrement Memory by One 
DEX Decrement Index X by One 
DEY Decrement Index Y by One 
EOR Exclusive-OR Memory with 

Accumulator 
INC Increment Memroy by One 
INX Increment X by One 
INY Increment Y by One 
JMP Jump to New Location 
JSR Jump to New Location 
Saving Return Address 
LDA Transfer Memory to 

Accumulator 
LDX Transfer Memory to Index X 
LDY Transfer Memory to Index Y 
LSR Shift One Bit Right (Memory 
or Accumulator) 
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NOP Do Nothing - No Operation 
ORA "OR" Memory with 

Accumulator 
PHA Push Accumulator on Stack 
PHP Push Processor Status on 

Stack 
FLA Pull Accumulator From Stack 
FLP Pull Processor From Stack 
ROL Rotate One Bit Left (Memory 

or Accumulator) 
ROR Rotate One Bit Right 

(Memory or Accumulator) 
RTI Return From Interrrupt 
RTS Return From Subroutine 
SBC Subtract Memory and Carry 

From Accumulator 
SEC Set Carry Flag 
SED Set Decimal Mode 
SEI Set Interrupt Disable Status 
STA Store Accumulator in 

Memory 
STX Store Index X in Memory 
STY Store Index Y in Memory 
TAX Transfer Accumulator to 

Index X 
TAY Transfer Accumulator to 

Index Y 
TSX Transfer Stack to Index X 
TXA Transfer Index X to 

Accumulator 
TXS Transfer Index X to Stack 

Register 
TYA Transfer Index Y to 

Accumulator 
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APPENDIX V A SAMPLE OUTPUT LISTING OF THE 
COMMODORE 64 ASSEMBLER 



LINE/* LOC CODE 



LIME 



00161 


CCE1 










00162 


CCE1 




• INIT THE MEMORY MANAGER (STARTUP COMES HERE 


00163 


CCE1 










00164 


CCE1 




GOOD 






00165 


CCE1 


A2 02 




LOX #S02 


:MGVE THREE BYTES 


00166 


CCE3 


BD OE CC WEDGE 


LDA JUMP.X 




00167 


CCE6 


95 7C 




STACHRG0T + 3.X 


00168 


CCE8 


CA 




DEX 




00169 


CCE9 


10 F8 




BPL WEDGE 




00170 


CCEB 










00171 


CCEB 


A5BA 




LDA FA 


;USE CURRENT FA FOR 
DEVICE ADDR 


00172 


CCED 


8D 77 CC 




STA SVFA 




00173 


CCFO 




; 






00174 


CCFO 




; SAY HELLO AND EXIT 




00175 


CCFO 










00176 


CCFO 


40 4B OF 




JMP MSG 


:PRINT HELLO (JSR/RTS) 


00177 


CCF3 




; 






00178 


CCF3 




; THIS IS WHERE WE COME TO DO THE WORK 


00179 


CCF3 










00180 


CCF3 




START 






00181 


CCF3 


85 A6 




STA BUFPT 


;SAVE .A, .X 


00182 


CCF5 


86 A7 




STX BUFPT +1 




00183 


CCF7 


BA 




TSX 


:ACTIVATED CALL IN 
■GONE' 


00184 


CCF8 


BD01 01 




LDAS0101.X 




00185 


CCFB 


C9E6 




CMP #.GONE 


:FROM A RUNNING 
PROGRAM?? 


00186 


CCFD 


F0 04 




BEQ TRY TWO 




00187 


CCFF 


C9 8C 




CMP #,MAIN 


;FROM DIRECT MODE?? 


00188 


CD01 


DO 17 




ONE NOTCMD 




00189 


CD03 


BO 02 01 


TRYTWO 


LDA S010^X 




00190 


CD06 


C9A7 




CMPWcGONE 


[PROGRAM? 


00191 


CD08 


F0 04 




BEQ FINDIT 




00192 


CDOA 


C9A4 




CMP#eMAIN 


IDIRECT? 


00193 


CDOC 


DOOC 




BNE NOTCMD 




00194 


CDOE 


A5A6 


FINDIT 


LDA BUFPT 


;GET THE COMMAND 
BACK 


00195 


CD10 


A2 08 




LDX#NCMD-1 




00196 


CD12 




FINDC 




:FIND THE COMMAND 


00197 


CD12 


DO 19 CC 




COMP CMD.X 




00198 


CD15 


FO 11 




BEQ CALL10 




00199 


CD17 


CA 




DEX 




00200 


CD18 


10 F8 




BPL FINDC 




002 01 


CD1A 










00202 


CDIA 




NOTCMD 






00203 


CD1A 


A5 A6 




LDA BUFPT 


;RESTORE REGS 


00204 


CDIC 


A6 A7 




LDX BUFPT +1 




00205 


CD1E 


C9 3A 




CMP#'; 


;CMPLETE CHRGOT 


0O2O6 


CD20 


BO 03 




BCS STRTS 




00207 


CD22 


4C80 00 




JMPCHRGOT + 7 




00208 


CD25 


4C8A00 


STHTS 


JMPCHROT + 17 


JQTHEENDOFCHRGOT 


00209 


CD28 
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00210 CD28 CALL 10 

00211 CD28 86 A9 STC CNTDN ;SAVE INDEX 

00212 C02A 8D7ACC STA FLAG ;SAVE THE COMMAND 

FOR LATER 

00213 CD2D 20A3CE LSR RDFILE ;GET THE FILENAME AND 

LENGTH 

00214 CD30 A6A5 LDX CNTDN ;RESTORE INDEX 

00215 CD32 A9 27 LDA #,FILE ;SET FILENAME ADDRESS 
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APPENDIX VI EXPLANATION OF ERROR MESSAGES 

Error messages are given in the program listing accompanying the 
statements in error. The following is a list of all error messages 
which might be produced during assembly. 

"A MODE NOT ALLOWED 

Following the legal opcode, and one or more spaces, is the letter A 
followed by one or more spaces. The assembler is trying to use the 
accumulator (A = accumulator mode) as the operand. However, the 
opcode in the statement is one which does not allow reference to 
the accumulator. Check for a statement labelled A (an illegal 
statement), which this statement is referencing. If you were trying to 
reference the accumulator, look up the valid operands for the 
opcode used. 

"A,X,Y,S,P RESERVED 

A label on a statement is one of the five reserved names {A, X, Y, S 
and P). They have special meaning to the assembler and therefore 
cannot be used as labels. Use of one of these names will cause this 
error message to be printed. No code will be generated for the 
statement. The label does not get defined and will appear in the 
symbol table as an undefined variable. Reference to such a label 
elsewhere in the program will cause error messages to be printed as 
if the label were never declared. 

"BRANCH OUT OF RANGE 

All of the branch instructions (excluding the two jumps), are 
assembled into type bytes of code. One byte is for the opcode and 
the other for the address to branch to. The branch is taken relative 
to the address of the beginning of the next instruction. If the value 
of the byte is 0-127, the branch is forward; if the value is 128-255, the 
branch is backward, (A negative branch is in two's complement 
form). Therefore, a branch instruction can only branch forward 127 or 
backward 128 bytes relative to the beginning of the next instruction. 
If an attempt is made to branch further than these limites, this error 
message will be printed. To correct, restructure the program. 

**CANT EVAL EXPRESSION 

In evaluating an expression, the assembler found a character it 
couldn't interpret as being part of a valid expression. This can 
happen if the field following an opcode contains special characters 
not valid within expressions (i.e. parentheses). Check the operand 
field and make sure only valid special characters are within a field 
{between commas). 



57 



"DUPLICATE SYMBOL 

The first field on tfie card is not an opcode so it is interpreted as a 
label. If the current line is the first line in which that symbol appears 
as a label (or on the left side of an equals sign), it is put into the 
symbol table and tagged as defined in that line. However, if the 
symbol has appeared as a label, or on the left of an equate prior to 
the current line, the assembler finds the label already in the symbol 
table. The assembler does not allow redefinitions of symbols and 
will, in this case, print this error message. 

* -FILE EXISTS 

The FILE EXISTS error message occurs when the object file named 
already exists on the diskette. This error can be corrected by 
scratching the old file or changing the diskette. 

"FILE NOT FOUND 

The FILE NOT FOUND error message is displayed when one of the 
following occurs: 

• The source file was not found 

• A .LIB specifies a nonexistent file 

• A .FIL specifies a nonexistent file 

The user should make sure that the filename is not misspelled, or 
that the wrong diskette was placed in the disk drive. 

"FORWARD REFERENCE 

The expression on the right side of an equals sign contains a 
symbol that hasn't been defined previously. One of the operations of 
the assembler is to evaluate expressions or labels, and assign 
addresses or values to them. The assembler processes the input 
Source Code sequentially, which means that all of the symbols that 
are encountered fall into two classes, i.e., already-defined symbols 
and not-previously-encountered symbols. The assembler assigns 
defined values and builds a table of undefined symbols. When a 
previously used symbol is discovered, it is substituted into the 
table. The assembler then processes all of the input statements a 
second time using currently defined values. 

A label or expression which uses a yet undefined value is 
considered to be referenced forward to the to-be-defined value. 

To allow for conformity of evaluating expressions, this assembler 
allows for one level of forward reference so that the following code 
is allowed. 

Card Sequence label opcode operand 

100 BNE NEWONE 

200 NEWONE LDA #5 



58 



The following is not allowed: 

Card Sequence label opcode operand 

100 BNE NEWONE 

200 NEWONE INC NEXT+5 

300 NEXT LDA #5 

This feature should not disturb the normal use of labels. The 
correction for this problem in this example is: 

Card Sequence label opcode operand 

100 BNE NEWONE 

300 NEXT LDA #5 

301 NEWONE INC NEXT+5 

This error may also mean that the value on the right side of the ' = ' 
is not defined at all in the progrann, in which case, the cure is the 
same as for undefined values. 

The assembler cannot process more than one level of computed 
forward reference. All expressions with symbols that appear on the 
right side of any equal sign must refer only to previously defined 
symbols for the equate to be processed. 

* 'ILLEGAL OPERAND TYPE 

After finding an opcode that does not have an implied operand, the 
assembler passes the operand field (the next non-blank field 
following the opcode) and determines what type of operand it is 
(indexed, absolute, etc.). If the type of operand found is not valid for 
the opcode, this error message will be printed. 

Check to see what types of operands are allowed for the opcode 
and make sure the form of the operand type is correct (see the 
section 1.1. on addressing modes). 

Check for the operand field starting with a left parenthesis. If it is 
supposed to be an indirect operand, recheck the correct format for 
the two types available. If the format was wrong (missing right 
parenthesis or index register), this error will be printed. Also check 
for missing or wrong index registers in an indexed operand (form: 
expression, index register). 

"IMPROPER OPCODE 

The assembler searches a line until it finds the first non-blank 
character string. If this string is not one of the 56 valid opcodes, it 
assumes it is a label and places it in the symbol table. It then 
continues parsing for the next non-blank character string. If none 
are found, the next line will be read in and the assembly will 
continue. However, if a second field is found, it is assumed to be an 
opcode (since only one label is allowed per line). If this character 
string is not a valid opcode, the error message is displayed. 
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This error can occur if opcodes are misspelled, in which case the 
assembler will interpret the opcode as a label (if no label appears on 
the card). It will then try to assemble the next field as the opcode. If 
there is another field, this error will be printed. 

Check for a misspelled opcode or for more than one label on a line. 

"INDEXED MUST BE X OR Y 

After finding a valid opcode, the assembler looks for the operand. In 
this case, the first character in the operand field is a left 
parenthesis. The assembler interprets the .lext field as an indirect 
address which, with the exception of the jump statement, must be 
indexed by one of the index registers, X or Y. In the erroneous case, 
the character that the assembler was trying to interpret as an index 
register is not X or Y and this error message is printed. 

Check for the operand field starting with a left parenthesis. If it is 
supposed to be an indirect operand, recheck the correct format for 
the two types available. If the format is wrong (missing right 
parenthesis or index registers), this error will be printed. Also, check 
for missing or wrong index registers in an indexed operand (form: 
expression, index registers). 

"INDIRECT OUT OF RANGE 

The assembler recognizes an indirect address by the parentheses 
that surround it. If the field following an opcode has parentheses 
around it, the assembler will try to assemble it as an indirect 
address. If the operand field extends into absolute mode, i.e., larger 
than 255, (two bytes would be required to specify the address), this 
error message will be printed. 

This error will only occur if the operand field is in correct form (i.e., ■ 
a index register following the address), and the address field is out 
of page zero. To correct this, the address field must refer to page 
zero memory. (The implied high order byte is 00). 

"INVALID ADDRESS 

An address referenced in an instruction, or the address in one of the 
assembler directives (.BYTE, .DBYTE., .WORD), is invalid. In the case 
of an instruction, the operand that is generated by the assembler 
must be greater than or equal to zero, and less than or equal to 
SFFFF (2 bytes long). (This excludes relative branches which are 
limited to + 127 or - 128 from the next instruction.) If the operand 
generates more than two bytes of code or is less tfian zero, this 
error message will be printed. For the .BYTE directive, each operand 
is limited to one byte. All address references must be greater than 
or equal to zero. 

This validity is checked after the operand is evaluated. Check for 
values of symbols used in the operand field (see the symbol table 
for this information). 
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"LABEL START NEED A-Z 

The first non-blank field is not a valid opcode. Therefore, the 
assembler tried to interpret it as a label. However, the first character 
of the field does not begin with an alphabetic character and the 
error message is printed. 

Check for an unlabelled statement with only an operand field that 
does start with a special character. Also check for an illegal label in 
the instruction. 

"LABEL TOO LONG 

All symbols are limited to six characters in length. When parsing, 
the assembler looks for one of the separating characters (usually a 
blank) to find the end of a label or string. If other than one of these 
separators is used, the error message will be printed providing that 
the illegal separator causes the symbol to extend beyond six 
characters in length. Check for no spacing between labels and 
opcodes. Also, check for a comment card with a long first word that 
doesn't begin with a semicolon. In this case the assembler is trying 
to interpret part of the comment as a label. 

"NON-ALPHANUMERIC 

Labels are made up of one to six alphanumeric digits. The label field 
must be separated from the opcode field by one or more blanks. It a 
special character or other separator is between the label and the 
opcode, this error message might be printed. 

Each of the 56 valid opcodes are made up of three aipfiabetic 
characters. Yhey must be separated from the operand field (if one is 
necessary) by one or more blanks. If the opcode ends with a special 
character (such as a comma), this error message will be printed. 

In the case of a lone label or an opcode that needs no operand, they 
can be followed directly by a semicolon to denote the rest of the 
card as a comment (use of a semicolon tabs the comment out to 
the next tab position). 

"PC NEGATIVE — RESET 

An assembled program is loaded into core in the range of position 
to 64K (65535). This is the extent of the machine. A maximum of two 
bytes can be used to define an address. Because there is no such 
thing as negative memory, an attempt to reference a negative 
position will cause this error and the program counter (or pointer to 
the current memory location) to be reset to zero. 

When this error occurs, the assembler continues assembling the 
code with the new value of the program counter. This could cause 
multiple bytes to be assembled into the same locations. Therefore, 
care should be taken to keep the program counter within the proper 
limits. 
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"RAN OFF END OF CARD 

This error message will occur if the assembler is looking for a 
needed field and runs off tfie end of thie card (or line image) before 
the field is found. The following should be checked for: a valid 
opcode field without an operand field on the same card: an opcode 
tfiat was thought to take an implied operand, which in fact needed 
an operand: an ASCII string that is missing the closing quote (make 
sure any embedded quotes are doubled; to have a quote at the end 
of the string, there must be three quotes, two for the embedded 
quote and one to close off the string): a comma at the end of the 
operand field indicates there are more operands to come: if there 
aren't other operands, the assembler will run off the current line 
looking for them. 

"READ ERROR 

This message refers to a disk drive read error. Refer to your disk 
drive manual for a description of these errors and their causes. 

"UNDEFINED DIRECTIVE 

All assembler directives begin with a period. If a period is the first 
character in a non-blank field, the asembler interprets the following 
character string as a directive. If the character string that follows is 
not a valid assembler directive, this error message will be printed. 

Check for a misspelled directive or a period at the beginning of a 
field that is not a directive, 

"UNDEFINED SYMBOL 

This error is generated by the second pass. If in the first pass the 
assembler finds a symbol in the operand field (the field fallowing 
the opcode or an equals sign), that has not been defined yet, the 
assembler puts the symbol into the table and flags it for 
interpretation by pass two. If the symbol is defined (shows up on 
the left of an equate or as the first non-blank field in a statement), 
pass one will define it and enter it in the symbol table. Therefore, a 
symbol in an operand field, found before the definition, will be 
defined with a value when pass tvi-o assembles it. In this case, the 
assembly process can be completed. This is what is meant by one 
level of forward reference. (See Forward Reference Error). 

However, if pass one doesn't find the symbol as a label or on the 
left of an equate, the assembler never enters it in the symbol table 
as a defined symbol. When pass two tries to interpret the operand 
field the symbol is in, there is no corresponding value for the 
symbol and the field cannot be interpreted. Therefore, the error 
message is printed with no value for the operand. 
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This error will also occur if a reserved symbol A, X, Y, S, or P, is 
used as a label and referred to elsewhere in the program. On the 
statement that references the reserved symbol, the assembler sees 
it as a symbol that has not been defined. Check for use of resen/ed 
symbols, misspelled labels or missing labels to correct this error. 

Note: When the assembler finds an expression (whether it is in an 
OPERAND field or on the right of an equals sign) it tries to evaluate 
the expression. If there is a symbol within the expression that hasn't 
been defined yet, the assembler will flag it as a forward reference 
and wait to evaluate it in the second pass. If the expression is on 
the right side of an equal sign, the forward reference is a severe 
error and will be flagged as such. However, if the expression is in an 
OPERAND field of a valid OPCODE, the first pass will set aside two 
bytes for the value of the expression and flag it as a forward 
reference. When the second pass fills in the value of the expression, 
and the value of the expression is one byte long i.e., 256, the 
instruction is one byte longer than required. This is because the 
forward reference to page zero memory wastes one byte of memory 
(the extra one that was saved). During the first pass, the assembler 
didn't know how large the value was, so it saved for the largest 
value which was two bytes. 
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APPENDIX VII EDITOR64 COMMAND SUMMARY 



Cominand 

AUTO n1 
AUTO 

CHANGBs1/s2/,n1-n2 

CHANGE/S1/S2/ 

CPUT"FILE" 

DELETE n1 n2 

FtND/s1/,n1.n2 

FIND/sl/ 

FORMAT n1-n2 

GET"FILE",n1-n2,n3 

GET" FILE" 

KILL 

LIST 

NUMBER n1,n2,n3 

PUT"FILE",n1-n2,n3,n4 

PUT"FILE" 



Description 

Starts automatic line numbering 

Shuts off auto 

Cliange strii'ig in line range 

Change string no range 

Compacted PUT, unnecessary spaces are 
removed 

Delete range 

Find string in line range 

Find string no range 

Print formatted 

Bring in text from disk file 

Short form GET 

Disable the editor 

List lines of text 

Renumber text 

Save text on disk file 

Save text short form 
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APPENDIX VIM MONITOR COMMAND SUMMARY 



ASSEMBLE 


A 


COMPARE 


C 


DISASSEMBLE 


D 


FILL 


F 


GO 


G 


HUNT 


H 


INTERROGATE 


1 


LOAD 


L 


MEMORY 


M 


NEW LOCATOR 


N 


REGISTERS 


R 


SAVE 


S 


TRANSFER 


T 



EXIT 



Assemble a line of machine code 

Compare two sections of memory and 
report differences 

Disassemble a line of 6502 code 

Fill memory with the specified address 

Start execution at the specified address 

Hunt through memory for all 
occurrences of certain bytes 

Interrrogate memory, showing the ASCII 
values of the memory locations 

Load a file from tape or disk 

Display the hexadecimal values of 
memory locations 

Adjust machine language program after 
moving it 

Display the CPU registers 

Save to tape or disk 

Transfer code from one section of 
memory to another 

Exit 64MON {BASIC wilt need to be 
reset) 
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COMMAND 

@ 

@C(dr):newfile([voll) = oldfile{[vol]) 

@l(dr) 

@N(dr):disknanne,id 

@Q 

@ R(dr}:newf ile([vo!]} = oldf i!e([vol]} 

@S(dr):filename(*K(vol]) 

@UJ 

@$(dr):{filenameX*K[vol]) 

#n 

/filename 
%filename 

t filename 

■^filename 



DESCRIPTION 

Current disk status 

Copy a file 

Initialize a drive 

Format a disk 

Kill tfie wedge program 

Rename a file 

Scratch a file 

Reset the DOS 

Read the directory 

All DOS commands will go to 
n where n is 8 to 15 inclusive 

Load a file (at BASIC) 

Load a file {at its own load 
address) 

Load a file (at BASIC) and run 
it 

Save a file 



Please Note: 'Vol' is any character enclosed in square brackets; 'dr' 
must be (zero) or 1 (one) for the respective drives. 
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COMPUTER 
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Printeci in Hting Kong 



